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Document Change List 


Version 0.1: (July 10,1995) Initial version 
Added over previously current header files: 

1. PnP_SUB_TYPE = VMEBridge = 6 

2. PnP INTERFACE = General VMEBridge = 0 

3. BUS_ID = VMEDEVICE = 0x100 


Version 0.2: (July 24, 1995) 

1. Residual. VitalProductData.ExtendedVPD changed from a pointer to an unsigned long offset. 
2. EXTVPDPNP.H (IBM type = 0x10) added. 

3. Comment added regarding use of DevID field (Motorola request). 


Version 0.3: (October 5, 1995) 

1. FirmwareSupplier = Firm Works added. 

2. PnP SUB TYPE = SystemPlanar and PnP INTERFACE = GeneralSystemPlanar added 
3. Grackle added to CHPIDPNP.H. 


Version 0.4: (December 8, 1995) 
1. IBM2782352 added to CHPIDPNP.H as IBM8109 
2. TBCTLPNP.H added: Timebase Control PNP packet. 


Version 0.5: (April 3, 1996) 

1. RESIDUAL.H: FirmwareSupplier = Bull added (0x03). 

2. PnP INTERFACE: CHRP Floppy and CHRPSystemStatusLED added 
3. Dallas 1585 added to CHPIDPNP.H. 

4. 12.1” Color TFT Displays added to DISPPNP.H. 


Version 0.6: (July 10, 1996) 
1. RESIDUAL.H: typedef enum CPU STATE: add CPU NOT PRESENT = 255 


1.1 Introduction 5 


1.0 Residual Data 





1.1 Introduction 


Residual Data is a data structure that is generated primarily by the system firmware and placed in 
memory prior to the transfer of control to the operating system. Register r3 is left with a pointer to this 
data. The data consists of a header area followed by a structured description of the underlying hardware. 
A major portion of this information is a device tree that is fashioned after the ISA Plug and Play 
Specification; the DevicePnPHeap is a collection of Plug and Play resource tags. 


This document contains definitions and explanations of all elements of the Residual Data structure for 
PowerPC Reference Platform systems. The C language structure files covering residual data are included 
as an appendix to this document but the latest levels should be obtained via anonymous FTP from 
ftp.austin.ibm.com in directory /pub/technology/spec. 


The residual data structure consists of: 


e residual.h contains the header and fixed fields of the structure (Appendix A). 


* pnp.h contains enumerations associated with various components of residual .h and defines 
the structure of the available Plug and Play resource tags (Appendix B). 


* A set of vendor-specific Plug and Play tags defined specifically for IBM PowerPC Reference 
Platform systems. 


1.2 Notation 


Standard C Language notation may be assumed throughout this document. 
All structures use Big-Endian data format except for the Plug and Play resource tags (in 
RESIDUAL.DevicePnPHeap) which are in Little Endian format in accordance with the Plug and Play 


architecture. 


Reserved fields in all structures must be set to zero by the firmware. 
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1.3 residual.h 


This section contains explanations of the terminology and intended usage of residual data fields. The 
figure below is a high level view of the entire structure; details of individual fields follow. In this 


representation, groups of fields are marked with an 


asterisk to indicate that they are part of an array. 


These fields are typically repeated for all elements of the array, but are shown here only once for clarity 
and brevity. Each row in the figure is 4 bytes in length with offset 0 at the top. 
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1.3.1 RESIDUAL.ResidualLength (4 Bytes) 





This is the length, in bytes, of the entire residual data structure as it would reside in memory. This length 
is calculated as a function of MAX CPUS, MAX MEM SEGS, MAX MEMS, MAX DEVICES, and 
AVE PNP SIZE. RESIDUAL.ResidualLength is, therefore, fixed for a particular version of the 
structure. 


1.3.2 RESIDUAL. Version (1 Byte) 


Contains the version of the residual data structure. The version starts with 0 and gets increased by I 
whenever a change is made that affects fields other than the field location being changed , i.e. offsets into 
the structure are affected. 


1.3.3 RESIDUAL.Revision (1 Byte) 


Contains the revision of the residual data structure. The revision starts with 0 and gets increased by 1 
when a change is made to an existing field (other than a reserved field) that does not affect the binary 
compatibility of the other parts of the structure. Adding meaning to a reserved field or adding a new flag 
or decode point does not constitute a revision change. 


1.3.4 RESIDUAL.EC (2 Bytes) 


Contains the engineering change level of the residual data structure. The EC level starts with 0 and gets 
increased by 1 when a fix is made to an existing version/revision. 


1.3.5 RESIDUAL. VitalProductData (236 Bytes) 


Vital Product Data (VPD) is information about system components that is useful in establishing the 
identity and capabilities of the system. See Table 1.4 on page 12 for details of this part of the structure. 


1.3.6 RESIDUAL.MaxNumCpus (2 Bytes) 


Contains the maximum number of cpus that is supported by the system being described. This is defined 
differently than MAX_CPUS, which is the maximum number of cpus for this version of the structure 
and is a parameter of the structure size. 


1.3.7 RESIDUAL.ActualNumCpus (2 Bytes) 


This is the actual number of cpus installed on the system being described. If this is less than 
MaxNumCpus, there are unpopulated or otherwise unusable processor locations in the system. 
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1.3.8 RESIDUAL.Cpus[MAX_CPUS] (8 Bytes per CPU) 


This is an array of elements identifying each cpu in the system. Each element contains the following 
fields (typedef PPC_CPU): 


e RESIDUAL.Cpus[].CpuType (4 Bytes): CPU version/revision that results from a mfspr from the 
Processor Version Register (PVR). 


e RESIDUAL.Cpus[].CpuNumber (1 Byte): This cpu number identifies a cpu in a multiprocessor 
configuration and corresponds to the number used for interprocessor interrupts. The CpuNumber for 
Cpu[0] in a uniprocessor system must be 0. 


e RESIDUAL.Cpus[].CpuState (1 Byte): 


Table 1. RESIDUAL.Cpus[].CpuState 

















Value Name Description 

0x00 CPU_GOOD This Cpu is present and active 

0x01 CPU_GOOD_FW This Cpu is present and executing firmware code. 
0x02 CPU_OFF This Cpu is present, but not active. 

0x03 CPU_FAILED This Cpu is present and active, but failed post. 
OxFF CPU_NOT_PRESENT The Cpu is not present. 








e RESIDUAL.Cpus[].Reserved (2 Bytes) 


1.3.9 RESIDUAL.TotalMemory (4 Bytes) 


The total number of bytes of system memory installed. If RESIDUAL. VitalProductData. WordWidth = 
64, the field is expressed in pages (RESIDUAL. VitalProductData.PageSize) rather than bytes. 


1.3.10 RESIDUAL.GoodMemory (4 Bytes) 


The total number of bytes of good system memory installed. If 
RESIDUAL. VitalProductData.WordWidth = 64, the field is expressed in pages 
(RESIDUAL. VitalProductData.PageSize) rather than bytes. 


1.3.11 RESIDUAL.ActualNumMemSegs (4 Bytes) 


Indicates the number of elements of the RESIDUAL.Segs array that are actually used. 


1.3.12 RESIDUAL.Segs[MAX_MEM_SEGS] (12 Bytes per Memory 
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Segment) 


This is an array of elements identifying each memory segment in the system. Each element contains the 
following fields (typedef MEM_MAP): 


e RESIDUAL.Segs[].Usage (4 Bytes): gives the intended usage of the memory segment as given in 
Table 2 on page 9. 


e RESIDUAL.Segs[].BasePage (4 Bytes): gives the base address as a page number. 
e RESIDUAL.Segs[].PageCount (4 bytes): gives the size of the segment in pages. 


Table 2. RESIDUAL.Segs[].Usage 









































Value Name Description 
0x0 Undefined 
0x01 FirmwareStack Stack for firmware usage 
0x02 FirmwareHeap Heap area for firmware usage 
0x04 FirmwareCode Code area for firmware usage 
0x08 BootImage Location of boot image 
0x10 Free Free memory range 
0x20 Unpopulated Unpopulated memory range 
0x40 ISAAddr ISA address space 
0x80 PCIConfig PCI configuration area 
0x100 PCIAddr PCI address space 
0x200 SystemRegs System register area 
0x400 SystemIO System IO area 
0x800 IOMemory IO memory space 





Ox 1000 UnPopSystemROM —Unpoulated part of system ROM area 











0x2000 SystemROM System ROM area (populated) 
0x4000 ResumeBlock Power management usage 
0x8000 Other Other usage 





1.3.13 RESIDUAL.ActualNumMemories (4 Bytes) 


Indicates the number of elements of the RESIDUAL.Memories array that are actually used. 
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1.3.14 RESIDUAL.Memories[MAX_MEMS] (4 Bytes per Memory 
Module) 





This is an array of elements identifying each physical memory module in the system. Each element 
contains the following field (typedef PPC_MEM): 


e RESIDUAL.Memories[].SIMMSize (4 Bytes): size of the SIMM in MB. 0 means absent or bad. 


1.3.15 RESIDUAL.ActualNumDevices (4 Bytes) 


Indicates the number of elements of the RESIDUAL.Devices array that are actually used. 


1.3.16 RESIDUAL.Devices[ MAX DEVICES] (36 Bytes per Device) 


This is an array of elements identifying each I/O device in the system. Each element contains the 
following fields (typedef PPC_DEVICE): 


e RESIDUAL.Devices[].Deviceld (20 Bytes) is a structure that identifies the I/O device. See Table 3 
on page 10 for the components of this structure. 


Table 3. RESIDUAL.Devices[].Deviceld 





Component Size Description 


Identifies the bus on which this device resides. 
0x01 = ISADEVICE 
0x02 = EISADEVICE 
0x04 = PCIDEVICE 
0x08 = PCMCIADEVICE 
BusId 4 bytes 0x10 = PNPISADEVICE 
0x20 = MCADEVICE 
0x40 = MXDEVICE 
0x80 = PROCESSORDEVICE 
0x0100 = VMEDEVICE 
0x0200-0x80000000 = undefined 





Device Identifier appropriate for the BusId. Use of this field is intended 
primarily for ISA devices; most other devices are readily identified 





Devld bytes through their configuration methods. Current usage is limited to ISA 
devices and PCI-PCI bridges which both use PnP device ids. 
SerialNum 4 bytes Used to distinguish multiple occurrences of the same DevId 
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Table 3. RESIDUAL.Devices[].Deviceld 





Component Size 


Flags 4 bytes 


Description 


Provides system characteristics associated with the device. 
0x0001 = Output 

0x0002 = Input 

0x0004 = ConsoleOut 

0x0008 = Consoleln 

0x0010 = Removable 

0x0020 = ReadOnly 

0x0040 = PowerManaged 

0x0080 = Disableable 

0x0100 = Configurable 

0x0200 = Boot - device can be used by boot. 

0x0400 = Dock - device is on a docking station. 

0x0800 = Static - not dynamically configurable. 

0x1000 = Failed - device failed POST. 

0x2000 = Integrated - device is integrated (on the planar), not remov- 
able. 

0x4000 = Enabled 

0x8000-0x80000000 = undefined 





BaseType 1 byte 


Most general classification of the device. See Table 6 on page 15 





SubType 1 byte 


More specific classification of the device. See Table 6 on page 15 





Interface 1 byte 


Characterizes the programming interface for the device. See Table 6 on 
page 15 





Spare 1 byte 





e RESIDUAL.Devices[].BusAccess (4 Bytes) is a union of the structures shown in Table 4 on page I I 


Table 4. RESIDUAL.Devices[].BusAccess 





























Struct name Element name Size Description 
CSN 1 byte Card Select Number 
PnPAccess LogicalDevNumber 1 byte 
ReadDataPort 2 bytes ee P the Oange 
SlotNumber 1 byte 0 if unknown 
ISA Access LogicalDevNumber 1 byte 0 if unknown 
ISAReserved 2 bytes 0 
SlotNumber 1 byte 
MCA Access LogicalDevNumber 1 byte 
MCAReserved 2 bytes 0 
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Table 4. RESIDUAL.Devices[].BusAccess 











Struct name Element name Size Description 
SlotNumber 1 byte 
PCMCIAAccess LogicalDevNumber I byte 





PCMCIAReserved 2 bytes 0 





























SlotNumber I byte 0 if unknown 
EIS AAccess FunctionNumber 1 byte 0 if unknown 
EIS AReserved 2 bytes 0 
BusNumber 1 byte 
PCIAccess DevFuncNumber I byte 
PCIReserved 2 bytes 0 
BusNumber 1 byte 
ProcBus Access BUID 1 byte 
ProcBusReserved 2 bytes 0 





e RESIDUAL.Devices[].AllocatedOffset (4 Bytes): Offset into RESIDUAL.DevicePnPHeap for the 
allocated resource description.This points to the list of Plug and Play descriptors for resources that 
are actually allocated to the device. 


e RESIDUAL.Devices[].PossibleOffset (4 Bytes): Offset into RESIDUAL.DevicePnPHeap for the 
possible resource description.This points to the list of Plug and Play descriptors for resources that are 
alternatives to be used in the event of resource contention or reconfiguration. 


e RESIDUAL.Devices[].CompatibleOffset (4 Bytes): Offset into RESIDUAL.DevicePnPHeap for the 
compatible resource description.This points to the list of Plug and Play descriptors for resources that 
are compatible with the allocated device. 


1.3.17 RESIDUAL.DevicePnPHeap[2*MAX DEVICES*AVE PNP SIZE 
] 


The DevicePnPHeap is a collection of Plug and Play resource descriptors. Access to the descriptor list 
for each device is provided through RESIDUAL.Devices[].AllocatedOffset, 
RESIDUAL.Devices[].PossibleOffset, and RESIDUAL.Devices[].Compatible Offset. 


1.4 Vital Product Data 


Vital Product Data (VPD) is information about the hardware platform or configuration that is not easily 
determined directly by the software. Some amount of VPD is provided by the firmware in the residual 
data structure. Refer to Table 5 on page 13 for details of this data structure. 
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Table 5. 


Vital Product Data 





Name 


PrintableModel 


Size 


32 bytes 


Description 


This is a null terminated string that must be of the form: 
vvv<0x20><model designation><0x0> where vvv is the EISA Vendor ID. 
Example: IBM PPS MODEL 601 5<trailing nulls> 





Serial 


16 bytes 


The serial number must be of the form: 
vvv<serial number> where vvv is the EISA Vendor ID. 
Example: IBM6015123456789 





Reserved 


48 bytes 


Must be set to 0x0 by the firmware. 





FirmwareSupplier 


4 bytes 


IBMFirmware = 0x00 

MotoFirmware = 0x01 

FirmWorks = 0x02 

Bull = 0x03 

Firmware suppliers requiring unique identification in this field should contact 
rj @ausvm6.vnet.ibm.com. 





FirmwareSupports 


4 bytes 


0x0001 = Conventional - this refers to pre- Open Firmware implementations. 
0x0002 = OpenFirmware 

0x0008 = LowDebug 

0x0010 = Multiboot 

0x0020 = LowClient 

0x0040 = Hex41 - see the Reference Platform boot process for further information. 
0x0080 = FAT - File Allocation Table file system supported. 

0x0100 = IS09660 - CD-ROM format supported 

0x0200 = SCSI_Initiator_Override - firmware allows the SCSI initiator id to be 
overridden to support multi-initiator configurations. See section on NVRAM. 
0x0400 = Tape_Boot supported 

0x0800 = FW_Boot_Path - see NVRAM specification. 

0x 1000-0x80000000 = undefined 





NvramSize 


4 bytes 


The size of NVRAM in bytes. 





NumSIMMSlots 


4 bytes 


Number of SIMM slots in the system. 





EndianS witchMethod 


2 bytes 


There are currently two methods for changing the endian mode of the memory con- 
troller. 

0x00 = undefined 

0x01 = UsePort92 - ISA port 0x92 

0x02 = UsePCIConfig A8 - PCI configuration register Oxa8, bit 5. 

0x03 = UseFF001030 - bit 9 

0x04-0xFFFF = undefined 





SpreadlOMethod 


2 bytes 


There are currently two methods for setting contiguous/noncontiguous I/O mode: 
0x00 = UsePort850 - ISA port 0x850 

0x01 = UsePCIConfigA8 - PCI configuration register Oxa8, bit 19 

0x02-0xFFFF = undefined 





Smplar 


4 bytes 


Symmetrical multiprocessor Instruction address register - set by the MP operating 
system to tell the firmware where to branch to on termination of a spin loop during 
MP initialization. 





RAMErrorLogOffset 


4 bytes 


Offset into RESIDUAL.DevicePnPHeap for Error Log Descriptor. 





Reserved5 


4 bytes 


Must be set to 0x0 by the firmware. 
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Table 5. Vital Product Data 
Name Size Description 
Reserved6 4 bytes Must be set to 0x0 by the firmware. 
ProcessorHz 4 bytes Processor speed in Hertz. 
ProcessorBusHz 4 bytes Processor Bus speed in Hertz. 
Reserved7 4 bytes Must be set to 0x0 by the firmware. 
Defined as the number of bus clocks per timebase clock times 1000. For example, 
TimeBaseDivisor 4 bytes if the timebase is running at 1/4 the rate of the bus clock, the TimeBaseDivisor is 
4000. 
He AA j ; ; Pere y 
WordWidth 4 bytes Set to 32 for 32-bit PowerPC processor implementations and to 64 for 64-bit imple- 
mentations. 
PageSize 4 bytes Memory page size in bytes; most often set to 4096. 
CoherenceBlockSize 4 bytes Unit of the L1 cache on which coherency is maintained. This is normally the same 
as the CacheLineSize. 
P Unit if the L1 Cache used by an operating system to allocate lock variables; nor- 
GrannleSize Kbytes mally the same as the CacheLineSize. 
å The size of the L1 Cache in K bytes. This is the fotal size of the cache, whether com- 
CacheSize 4 bytes r : 
bined or split. 
L1 Cache attributes: 
z 0 = NoneCAC - no cache 
Thence 4bytes 1 = SplitCAC - Split 1&D) cache 
2 = CombinedCAC - Combined (I &D) cache 
Gachensece 4 bytes L1 Cache Associativity. This is used for a combined cache; if the cache is split, put 
zeros here. 
CacheLineSize 4 bytes L1 Cache size in bytes. This is used for a combined cache; if the cache is split, put 


zeros here. 





























I CacheSize 4 bytes L1 Instruction Cache size in bytes. For combined cache, put total here. 
I CacheAssoc 4 bytes L1 Instruction Cache associativity. For combined cache, put total here 
I CacheLineSize 4 bytes L1 Instruction Cache line size in bytes. For combined cache, put total here 
D CacheSize 4 bytes L1 Data Cache size in bytes. For combined cache, put total here. 
D CacheAssoc 4 bytes L1 Data Cache associativity. For combined cache, put total here 
D CacheLineSize 4 bytes L1 Data Cache line size in bytes. For combined cache, put total here 
TLBSize 4 bytes Total size of Translation Lookaside Buffer in number of entries. 
Translation Lookaside Buffer attributes: 
TBA Fbyies i i ie split ARD) TLB 
2 = CombinedTLB - combined (I &D) TLB 
TLBAssoc 4 bytes TLB Associativity. This is used for a combined TLB; if split, put zeros here. 
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Table 5. Vital Product Data 

















Name Size Des cription 

I TLBSize 4 bytes Number of Instruction TLB entries; for combined TLB, put total here. 

I TLBAssoc 4 bytes Instruction TLB associativity; for combined TLB, put total here. 

D TLBSize 4 bytes Number of Data TLB entries;. for combined TLB, put total here. 

D TLBAssoc 4 bytes Data TLB associativity; for combined TLB, put total here. 

ExtendedVPD 4 bytes Offset for extended VPD (generally into DevicePnPHeap); zeros if unused. 





1.5 Device Types 


Table 6. Plug and Play Device Types 





PnP_BASE_TYPE PnP_SUB_TYPE PnP_INTERFACE 


0 = Reserved 





0 = SCSIController 0 = GeneralSCSI 





0 = GeneralIDE 


1 = IDEController 


1 = ATACompatible 





0 = GeneralFloppy 
1 = Compatible765 
2=NS398 Floppy - NS SuperI/O with index/data regs at port 398 


1 = MassStorageDevice 2 = FloppyController 3 = NS26E_Floppy - NS at port 26E 


4=NS15C Floppy - NS at port 15C 
5=NS2E Floppy - NS at port 02E 
6 = CHRP Floppy 





3 = IPIController 0 = Generall[ PI 





0x80 = OtherMassStorageControl- 











ler 

0 = EthernetController 0 = GeneralEther 
= Neworkiitertace 1 = TokenRingController 0 = GeneralToken 
Controller 2 = FDDI Controller 0 = GeneralFDDI 





0x80 = OtherNetworkController 











0 = VGAController 0 = GeneralVGA 

1 = SVGAController 0 = GeneralSVGA 
3 = DisplayController 

2 = XGAController 0 = GeneralXGA 





0x80 = OtherDisplayController 
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Table 6. Plug and Play Device Types 





PnP_BASE_TYPE 


4= MultimediaController 


PnP_SUB_TYPE 


0 = VideoController 


PnP_INTERFACE 


0 = General Video 





1 = AudioController 


0 = GeneralAudio 
1 = CS4232Audio 





0x80 = OtherMultimediaControl- 








ler 
0 = GeneralRAM 
0=RAM 0 = PCIMemoryController - PCI config. 
1 = RS6KMemoryController 
5 = MemoryController 
1 = FLASH 0 = GeneralFLASH 





0x80 = OtherMemoryDevice 





6 = BridgeController 


0 = HostProcessorBridge 


0 = GeneralHostBridge 





1 = ISABridge 


0 = Generall SABridge 





2 = EISABridge 


0 = GeneralEIS ABridge 





3 = MicroChannelBridge 


0 = General MCA Bridge 





4 = PCIBridge 


0 = PCIBridgeDirect - memory mapped PCI bus configuration 

1 = PCIBridgelndirect - PCI bus configuration space accessed 
through CF8, CFC 

2 = PCIBridgeRS6K - PCI bus configuration space accessed 
through system control area (high 16 MB - used by RS/6000 sys- 
tems). 





5= PCMCIABridge 


0 = GeneralPCMCIABridge 





6= VMEBridge 


0 = General VMEBridge 





0x80 = OtherBridgeDevice 





7 = CommunicationsDevice 


0 = RS232Device 


0 = GeneralRS232 

1 = COMx 

2 = Compatible 16450 

3 = Compatible 16550 

4 = NS398SerPort - NS SuperI/O with index/data regs at port 398 
5 = NS26ESerPort - NS at port 26E 

6 = NS15CSerPort - NS at port 15C 

7 = NS2ESerPort - NS at port 02E 





1 = ATCompatibleParallelPort 


0 = GeneralParPort 

1 = LPTx 

2 = NS398ParPort - NS SuperI/O with index/data regs at port 398 
3 = NS26EParPort - NS at port 26E 

4 = NS15CParPort - NS at port 15C 

5 = NS2EParPort - NS at port 02E 





0x80 = OtherCommunicationsDe- 


vice 
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Table 6. Plug and Play Device Types 





PnP BASE TYPE 


8 = SystemPeripheral 


PnP_SUB_TYPE 


0 = ProgrammablelnterruptCon- 
troller 


PnP_INTERFACE 


0 = GeneralPIC 

1 =ISA_PIC - 8259 

2=EISA PIC 

3 = MPIC 

4 = RS6K_PIC (See RS/6000 interrupt architecture) 





1 = DMAController 


0 = GeneralDMA 
1=ISA_DMA 
2=EISA_DMA 





2 = SystemTimer 


0 = GeneralTimer 
1 =ISA_Timer 
2 = EISATimer 





3 = RealTimeClock 


0 = GeneralRTC 








1=ISA_RTC 
0 =none 
_ 1 = StoreThruOnly 
FO 2 = StoreInEnabled 
3 = RS6KL2Cache 
0 = IndirectNVRAM - indirectly addressed through ports 74-76 
5 =NVRAM 1 = DirectNVRAM - direct memory mapped NVRAM. 


2 = Indirect NVRAM24 - 24 bit addressing, indirectly addressed 
using ports 73-76. 





6 = PowerManagement 


0 = GeneralPowerManagement 
1 = EPOWPowerManagement - Emergency Power Off Warning 
2 = PowerControl - software control over power on/off 





7 = CMOS 


0 = GeneralCMOS 





8 = OperatorPanel 


0 = GeneralOPPanel 

1 = HarddiskLight 

2 = CDROMLight 

3 = PowerLight 

4 = KeyLock 

5 = ANDisplay - Alphanumeric Display (example: LCD panel) 
6 = SystemStatusLED 

7 = CHRPSystemS tatusLED 





9 = ServiceProcessorClass I 


0 = GeneralServiceProcessor 





OxA = ServiceProcessorClass2 


0 = GeneralServiceProcessor 





OxB = ServiceProcessorClass3 


0 = GeneralServiceProcessor 





OxC = GraphicAssist 


0 = none 

1 = TransferData 
2 = IGMC32 

3 = IGMC64 





OxF = SystemPlanar 


0 = GeneralSystemPlanar 





0x80 = OtherSystemPeripheral 
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Table 6. Plug and Play Device Types 





PnP_BASE_TYPE PnP_SUB_TYPE PnP_INTERFACE 


0 = KeyboardController 

1 = Digitizer 

2 = MouseController 

0x80 = OtherInputContoller 


9 = InputDevice 





1.6 Plug and Play Device Descriptors (Vendor Defined) 


Refer to the Plug and Play ISA Specification for a description of the tag architecture for device 
description. Only the tags defined by IBM will be discussed here (small resource item OxE and large 
resource item 0x4). These have been defined to meet IBM's specific product needs (primarily AIX), but 
will probably be useful to other platforms and OSs. Vendors should create new vendor-defined tags as 
needed. 


The primary documentation of these descriptors is the set of header files embedded in the following 
sections. Some clarification of potentially misinterpreted or confusing fields is included. 


The term descriptor may be used in addition to tag in this document for clarity and in order to retain a 
consistent terminology with other documents in use by readers. 


1.6.1 Vendor-defined Small Resource Items 


These descriptors may be up to 8 bytes in length. Byte 0 has the value ‘01110xxx’b where bit 7=0 
indicates that this is a small resource item, bits(6:3)=1110 is the small item name (OxE), and xxx is the 
number of bytes to follow (1-7). For IBM vendor defined tags, byte I is, by convention, a type byte 
which is used to distinguish between the tags. Type = 0x0 is reserved for non-IBM use. 


1.6.1.1 Type=0x01: Chip Identification 


This descriptor is used to identify a particular chip that implements a function when it is necessary to 
relate some chip-specific information. See the header file, CHPIDPNP.H (below) for details and chip 
identifiers. 


#ifndef CHPIDPNP 
fidefine CHPIDPNP 


#define ChipID Packet 0x70 /* tag for ChipIDPack without size */ 
/* The chipid is the vendor id followed by 4 hex digits, e.g., for IBM 
platforms: Chip ID=IBMxxxx. To avoid confusion with PnP Device IDs, IBM 
chip ids will begin at 0x8000. Chip ids are assigned to ranges based on 
function (see below) and are unique to the chip, i.e. a chip may have 


multiple functions, but only one id */ 


typedef enum Chip ID ( 
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/* 


/* 


/* 
/* 
/* 
/* 
/* 
/* 
/* 


/* 


/* 


/* 


/* 


/* 


/* 


/* 


/* 


Memory Controllers 
Dakota = 0x8001, 

Idaho = 0x8002, 

Eagle = 0x8003, 
Kauai_Lanai = 0x8004, 
Montana_Nevada = 0x8005, 
Union = 0x8006, 
Cobra_Viper = 0x8007, 
Grackle = 0x8008, 


SA Bridge Chips 
SIO ZB = 0x8100, 
FireCoral = 0x8101, 


PCI Bridge chips 
Dakota = 0x8001, 


Idaho = 0x8002, 

Eagle = 0x8003, 
Kauai_Lanai = 0x8004, 
Montana_Nevada = 0x8005, 


Union = 0x8006, 
Python = 0x8102, 
DEC21050 = 0x8103, 
IBM2782351 = 0x8106, 
IBM2782352 = 0x8109 


PCMCIA Bridge Chips 
NTEL 8236SL = 0x8104, 
RICOH RF5C366C = 0x8105, 


EISA Bridge Chips 
NTEL 82374 = 0x8108, 











MCA Bridge Chips 
MCACoral = 0x8107, 


L2 Cache controller 
Cheyenne = 0x8200, 
IDT = 0x8201, 
Sony1PB = 0x8202, 
Mamba = 0x8203, 
Alaska = 0x8204, 
Glance = 0x8205, 
Ocelot 0x8206, 
Eagle = 0x8003, 


Power management chips 
Carrera = 0x8300, 
Sig750 = 0x8301, 


Interrupt Controller Chips 
MPIC 2 = 0x8400, 


Miscellaneous Planar Chips 
DallasRTC = 0x8F00, 
Dallas1585 = 0x8F01, 
Timer8254 = Ox8F10, 
HarddiskLt = Ox8FFO 


} Chip ID; 


typedef struct ChipIDPack ( 


/* 
/* 
/* 
/* 
/* 
/* 
/* 
/* 


/* 
/* 


/* 
/* 
/* 
/* 


/* 
/* 


/* 


/* 


/* 
/* 
/* 
/* 
/* 
/* 
/* 


/* 
/* 


/* 


/* 
/* 
/* 
/* 


/* 
/* 


Memory Controller Range: IBM80xx 
BM8001:IBM North/South Dakota 


BM8002:IBM Idaho 
BM8003:Motorola Eagle 
BM8004: IBM Kauai/Lanai 
BM8005: IBM Montana/Nevada 
BM8006: IBM Union 
BM8007: IBM Cobra/Viper 
BM8008:Motorola Grackle 


Bus Bridge Range: IBM81xx 
BM8100: Intel 82378ZB 
BM8101:IBM FireCoral 


Bus Bridge Range: IBM81xx 


BM8002:IBM Idaho 
BM8003:Motorola Eagle 
BM8004: IBM Kauai/Lanai 
BM8005: IBM Montana/Nevada 
BM8006: IBM Union 
BM8102:IBM Python 
BM8103 : PCI- PCI 

BM8106: PCI-PCI 

BM8109: PCI-PCI352 


Bus Bridge Range: IBM81xx 
BM8104: Intel 8236SL 
BM8105:RICOH RF5C366C 





Bus Bridge Range: IBM81xx 
BM8108:Intel 82374/82375 





Bus Bridge Range: IBM81xx 


BM8200: IBM Cheyenne 
BM8201: IDT 

BM8202: Sony 1PB 
BM8203: IBM Mamba 
BM8204: IBM Alaska 
BM8205: IBM Glance 
BM8206: IBM Ocelot 
BM8003:Motorola Eagle 


PM Chip Range: IBM83xx 
BM8300: IBM Carrera 
BM8301:Signetics 87C750 


PIC Chip Range: IBM84xx 
BM8400: IBM MPIC 2 


MISC Chip Range: IBM8Fxx 


BM8FFO:Op Panel HD light 





BM8001: IBM North/South Dakota 


BM8107: 6xxMx - T=1 MCA (servers) 


L2 Controller Range: IBM82xx 


BM8F00:Dallas 1385 compatible 
BM8FO1:Dallas 1585 compatible 
BM8F10: 8254-compatible timer 


[This packet identifies chip set ID. 
Details of these specifics are 


*/ 
*/ 
*/ 
*/ 
*/ 
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/* documented in the chip specs. */ 
unsigned char Tag; /* small tag = 0x7n with n bytes */ 
unsigned char Type; /* = 1 (Chip ID) */ 
unsigned char VendorID0; /* Bit (7)=0 */ 

/* Bits(6:2)=1st character in */ 

/* compressed ASCII */ 

/* Bits(1:0)=2nd character in */ 

/* compressed ASCII bits (4:3) */ 
unsigned char VendorID1; /* Bits(7:5)=2nd character in */ 

/* compressed ASCII bits (2:0) */ 

/* Bits(4:0)=3rd character in */ 

/* compressed ASCII */ 
unsigned char Name[2]; /* Chip ID name */ 

yr 7 

/* Example: IBM8001 */ 

/* I,B,M = 01001,00010, 01101 */ 

/* bytes 0,1 = 00100100,01001101 */ 

/* = 2 4 4 D “y 

/* byte 0 = 24 */ 

/* byte 1 = 4D */ 

/* byte 2 = O1 */ 

/* byte 3 = 80 */ 

pe */ 


} ChipIDPack; 


#endif /* ndef CHPIDPNP */ 
1.6.1.2 Type=0x03: Processor Number 


This descriptor defines the CPU number for a processor associated with a device array entry. See the 
header file, CPNUMPNP.H (below) for details. 


/* 10/25/95 */ 
/* Structure map for Processor Number in PnP Vendor specific packet */ 
/* See Plug and Play ISA Specification, Version 1.0a, March 24, 1994. */ 
/* It (or later versions) is available on Compuserve in the PLUGPLAY */ 
/* area. This code has extensions to that specification, namely new */ 
/* short and long tag types for platform dependent information */ 
/* Warning: LE notation used throughout this file */ 


/* This descriptor is used to define the relationship between processors and */ 
/* L2 caches. */ 


Hifndef _CPNUMPNP_ 
#define _CPNUMPNP_ 


#define CPNum_Packet 0x70 /* tag for CPNumPack without size */ 
typedef struct _CPNumPack { 
unsigned char Tag; /* small tag = 0x72 */ 
unsigned char Type; /* = 3 (Processor Number Descriptor) */ 
unsigned char ProcessorNumber; 


} CPNumPack; 


#endif /* ndef _CHNUMPNP_ */ 
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1.6.2 Vendor-defined Large Resource Items 


These descriptors may be up to 64K bytes in length. Byte 0 has the value ‘10000100’b where bit 7=1 
indicates that this is a large resource item, and bits(6:0)=0000100 is the large item name (0x4). The next 
two bytes indicate the length of the following data field, lower 8 bits followed by the upper 8 bits. For 
IBM vendor defined tags, byte 3 is, by convention, a type byte which is used to distinguish between the 
tags. Type = 0x0 is reserved for non-IBM use. 


1.6.2.1 Type=0x01: Diskette Drives 


This descriptor is used to describe the diskette drives attached to a diskette controller. It identifies the 
type of drive and whether it supports media sense, auto eject, and/or the alternate speed feature (for 4 
MB 3.5” diskettes). See the header file DSKTPNP.H (below) for details . 


tifndef _DSKTPNP_ 
#define _DSKTPNP_ 





#define Dskt Packet 0x84 /* tag for DsktInfoPack */ 
typedef enum DISKETTE FEATURE { 

MediaSense = 0x01, 

AutoEject = 0x02, 

AltSpeed = 0x04 /* 10/20/94 */ 


) DISKETTE FEATURE; 
typedef struct DsktDriveInfo { 


unsigned char Dskt; /* diskette drives info array */ 
/* 0 : no drive present */ 
/* 1 : 3.5” 2MB drive */ 
/* 2 : 3.5” 4MB drive */ 
/* 3 : 5.25” 1.6MB drive */ 
unsigned char Feature; /* DISKETTE FEATURE enum */ 


} DsktDriveInfo; 


typedef struct DsktInfoPack { 


unsigned char Tag; /* large tag = 0x84 Vendor specific */ 
unsigned char Count0; /* lo byte of number of drives + 1 */ 
unsigned char Countl; /* hi byte of number of drives + 1 */ 
/* Count ((CountO and Countl) - 1) / 2 = number of diskette drives */ 
unsigned char Type; /* = 1 (diskette) */ 
DsktDriveInfo DDInfo[1]; /* drive infomation */ 





} Dskt InfoPack; 


Hendif /* ndef DSKTPNP */ 


1.6.2.2 Type=0x02: L2 Cache 


This descriptor gives parameters (size, algorithms, features) relating to the L2 cache included in the 
system. See the header file L2PNP.H (below) for details. 


#ifndef L2PNP_ 
Hdefine _L2PNP_ 


Hdefine L2Info Packet 0x84 /* tag for L2Info Pack */ 
typedef enum L2 Store Algorithm { 
None = 0, 


WriteThru = 1, /* Store Thru */ 
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CopyBack = 2 
} L2 Store Algorithm; 


typedef enum L2 Cache Asc { 
DirectMapped = 1, 
TwoWay = 2 
} L2 Cache Asc; 


typedef enum L2 HW Assist { 
Invalidate = 1, 
Flush = 2 


} L2_HW Assist; 








typedef struct L2InfoPack { 
unsigned char Tag; 
unsigned char Count0; 
unsigned char Countl; 
unsigned char Type; 
unsigned char L2 CacheSize [4]; 
unsigned char L2_CacheAsc[2] ; 
unsigned char L2 LineSize[2]; 
unsigned char L2 SectorSize[2]; 
unsigned char L2 StoreAlgorithm; 
unsigned char L2 HWAssist; 


} L2InfoPack; 


fendif /* ndef L2PNP */ 


1.6.2.3 Type=0x03: PCI Bridge 


This descriptor is used to pass parameters associated with a PCI bridge (identification, configuration 


/* 


/* 
/* 


/* 
/* 


/* 
/* 
/* 
/* 
/* 
/* 


/* 
/* 


Store In 


ba 


direct mapped */ 
2-way */ 


xf 
*/ 


invalidate 
flush 


arge tag = 
= 0x0D sizeof(L2InfoPack - 
= 0 */ 

2 (L2 cache) */ 
n 1K bytes */ 
L2 Cache Asc enum */ 


0x84 Vendor specific */ 


3) * 


L2 Store Algorithm enum */ 
L2 HW Assist */ 





address, and interrupt mapping). See the header file PCIPNP.H (below) for details. 


#ifndef PCIPNP 
#define PCIPNP 


#define MAX PCI INTS 4 


typedef enum IntTypes ( 


IntInvalid = 0, 
IntCtl8259 = 1, 
IntCtlMPIC = 2, 
IntCtlRS6K = 3 
} _IntTypes; 


typedef struct IntMap { 


unsigned char SlotNumber; 
unsigned char DevFuncNumber; 
unsigned char IntCtrlType; 
unsigned char IntCtrlNumber; 
unsigned short Int [MAX PCI INTS]; 


/* 
/* 
/* 
/* 
/* 


/* 
/* 
/* 
/* 
/* 
/* 
/* 
/* 
/* 
/* 
/* 
/* 
/* 
/* 
/* 


interrupt cntlr types enumerator 
invalid value 
8259 
MPIC 
RS6K 


PCI Int to system conversion map 
First slot = 1; Integrated = Slot 0 
PCI slot’s DeviceFunction number 
Interrupt controller type 
Interrupt controller number 

0 8259 interrupt 

0 MPIC interrupt 

buid RS6K interrupt 
Interrupt mapping table 
0 for INTA 
1 for INTB 
2 for INTC 
index 3 for INTD 
OxFFFF if not usable 
Ox8nnn if edge sensitive 


index 
index 
index 
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} IntMap; 


typedef struct PCIInfoPack { 





unsigned char Tag; /* large tag = 0x84 Vendor specific */ 
unsigned char Count0; /* lo byte of count */ 
unsigned char Count1; /* hi byte of count */ 
/* count = number of PCI slots * sizeof (IntMap) + 21 */ 
unsigned char Type; /* = 3 (PCI bridge) */ 
unsigned char ConfigBaseAddress[8];/* Base address of PCI Configuration */ 
/* system real address */ 

unsigned char ConfigBaseData [8]; /* Base address of PCI Config data */ 
/* system real address */ 

unsigned char BusNumber; /* PCI Bus number */ 
unsigned char Reserved[3]1; /* Reserved (padded with 0) */ 
IntMap Map [1]; /* Interrupt map array for each PCI */ 
/* slots that are pluggable */ 

/* number = (count-21)/sizeof(IntMap) */ 


} PCIInfoPack; 


#endif /* ndef _PCIPNP_ */ 


1.6.2.4 Type=0x04: Display 


This descriptor is used to identify the type of display and various characteristics (resolution, bpp) of 
displays attached to portable systems. See the header file DISPPNP.H (below) for details. 


#ifndef _DISPPNP_ 
#define DISPPNP 


#define Disp Packet 0x84 /* tag for DisplayInfoPack */ 


typedef enum Display Mode ( 


Console Text = 0, /* Video in VGA text mode */ 
Console Video = T /* Video in 8 bpp graphics */ 
Console Videol6 = 2, /* Video in 5,6,5 graphics */ 
Console Video24 = 3, /* Video in 8,8,8 graphics */ 
Console Video32 = 4 
} Display Mode; 

typedef enum Display ID ( 
UnknownDisplay = 0x00, 
IBM_F8560 = Oxfa, /* IBM F8560 12.1” Color TFT 1024x768 */ 
IBM_F8550 = Oxfb, /* IBM F8550 12.1” Color TFT 800x600 */ 
IBM_F8532 = Oxfc, /* IBM F8532 10.4” Color TFT 800x600 */ 
TOSHIBA STNC = Oxfd, /* Toshiba 10.4” Color DSTN 640x480 */ 
IBM F8515 = Oxfe, /* IBM F8515 10.4” Color TFT 640x480 */ 
NoDisplay = DKXEE 
} Display ID; 

typedef struct DispInfoPack { 
unsigned char Tag; /* large tag = 0x84 Vendor specific */ 
unsigned char Count0; /* =9 */ 
unsigned char Count1; /* =0 */ 
unsigned char Type; /* = 4 (display) */ 
unsigned char DisplayMode; /* Display Mode enum */ 
unsigned char DisplayID; /* Display ID enum */ 
unsigned char Hor Pixels[2]; /* Horizontal resolution, e.g. 640 */ 
unsigned char Ver Pixels [2]; /* Vertical Resolution, e.g. 480 */ 
unsigned char BytesPerRow[2] ; /* Number of bytes per VRAM row */ 
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unsigned char VRAMAddr[8]; /* Location of video buffer */ 
unsigned char VRAMSize[8]; /* Size of video buffer */ 
} DispInfoPack; 


Hendif /* ndef _DISPPNP_ */ 


1.6.2.5 Type=0x05: Bridge Address Translation 


This descriptor is used to define address translations performed by a bus bridge. Bus bridges will 
generally observe addresses that appear on the parent and child busses and make a determination as to 
whether to respond to the address and, if so, whether to apply a translation to the address. The combined 
effect of these translations determine the physical memory map of the system. 


This descriptor provides for the specification of various types of decoding and address mapping that 
might be implemented in a bus bridge. See the header file BRATPNP.H (below) for details. 


e Decoding 


— Positive - particular addresses or ranges of addresses are decoded by the bridge and passed on ei- 
ther directly or translated. 


— Subtractive - particular addresses or ranges of addresses are decoded by the bridge only after a de- 
termination is made that the address cycle was not accepted by another agent on the bus. 


* Translation Type 
— Direct - the new address is generated by applying a simple offset to the original address. 


— Mapped - a translation table is used, where each address can potentially become a unique new ad- 
dress after translation. 


— PowerPC Special Storage Segment Translation 
Note: Need to write about the “private bit”. 


e Address Conversion 
— PIO BM - system addressing of bus memory. 
— PIO BIO - system addressing of bus I/O. 
— DMA BM Parent - DMA from bus memory to parent bus. 


e Addresses 


— Parent Base Address - for a mapped translation type, this is the parent bus address of the transla- 
tion table. 


— Bus Base Address - sibling bus 


— Bus Address Range - sibling bus address range. 


#ifndef BRATPNP 
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#define _BRATPNP_ 


#define BRAT Packet 0x84 


typedef enum Translation Flags { 


positive decode 


= 0x01 


} Translation Flags; 


typedef enum Translation Type ( 


direct = 1 
mapped = 2 


n 


r 


PPC Spec Seg 


3 


} Translation Type; 


typedef enum Address Conversion ( 


PIO BM = 1 
PIO BIO = 


1 


2, 


DMA_BM Parent 
} Address Conversion; 


3 


typedef struct BRATPack { 


unsigned c 
unsigned 
unsigned 
unsigned 
unsigned 
unsigned 
unsigned 
unsigned 
unsigned 
unsigned 
unsigned 
} BRATPack 


aqgqaqaaqaqaaaa 


nar 
nar 
nar 
nar 
nar 
nar 
nar 
nar 
nar 
nar 





nar 


i 


Tag; 

Count 0; 

Count1; 

Type; 

BRAT Flags; 

BRAT Type; 

BRAT Addr Conv; 
Reserved; 
ParentBaseAddress[8] ; 
BusBaseAddress [8] ; 
BusAddressRange [8] ; 


fendif /* ndef _BRATPNP_ */ 


/* 


/* 
/* 


/* 
/* 
/* 


/* 
/* 
/* 


/* 
/* 
/* 
/* 
/* 
/* 
/* 


tag for BRAT Pack */ 
0x0 = subtractive decode */ 
bits[7:1] are reserved */ 
direct translation */ 
mapped translation */ 
PowerPC special storage segment 

(T=1) translation */ 
PIO system to bus memory */ 
PIO system to bus I/O */ 
DMA bus memory to parent bus */ 
large tag = 0x84 Vendor specific */ 
= 0x1C sizeof (BRATPack) -3 */ 
= 0 */ 
= 5 */ 
Translation Flags */ 
Translation Type */ 
Address Conversion types */ 


1.6.2.6 Type=0x06: Bus Bridge Attributes 


This descriptor gives the sibling bus speed and number of slots. See the header file BBATRPNP.H 


(below) for details. 


#ifndef BBAT 
#define BBAT 


#define BBAT 


RPNP 
RPNP 


R Packet 0x84 


typedef struct _BBATRPack { 


unsigned 
unsigned 
unsigned 
unsigned 
unsigned 
unsigned 


qaqaqaqaaa 


} BBATRPac 


nar 
nar 
nar 
nar 
nar 
nar 





Tag; 

Count 0; 
Count1; 
Type; 
BusSpeed [4] ; 
NumSlots; 


/* 


/* 
/* 
/* 
/* 
/* 
/* 
/* 
/* 
/* 


tag for BBATR Pack */ 


large tag = 0x84 Vendor specific */ 
= 0x06 sizeof (BBATRPack - 3) */ 
= 0 */ 
= 6 */ 
bus speed in Hz */ 
number of bus slots */ 
ISA: FF = some number of slots */ 
are present. */ 
00 = there are no slots */ 
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Hendif /* ndef _BBATRPNP_ */ 


1.6.2.7 Type=0x07: SCSI Controller Information 


This descriptor gives the SCSI identifier for each SCSI bus connected to a controller. See the header file 
SCSIPNP.H (below) for details. 


#ifndef _SCSIPNP_ 
#define _SCSIPNP_ 


#define SCSICtlInfo Packet 0x84 /* tag for SCSIControllerPack */ 


typedef struct SCSIControllerPack { 


unsigned char Tag; /* large tag = 0x84 Vendor specific */ 
unsigned char Count0; /* = sizeof (SCSIControllerPack) - 3 */ 
unsigned char Count1; /* + BusCount - 1 */ 
unsigned char Type; /* = 7 (SCSI Controller) */ 
unsigned char BusCount; /* Number of SCSI busses on device */ 
unsigned char SCSIID[1]; /* Array with size of BusCount. */ 

/* Each entry contains SCSI ID of */ 

/* the indexed SCSI bus */ 


} SCSIControllerPack; 


Hendif /* ndef SCSIPNP */ 


1.6.2.8 Type=0x08: Power Management Support 


This descriptor gives the supported attributes of the system’s power management implementation. See 
the attributes table and the header file PMSPTPNP.H (below) for details. 


Table 7. Power Management Attributes 




















PMattribute Byte/bit Name Description 
0x0001 B4/b0 iibernath i Firmware supports resume from hibernation (all system components 
x LOM ANS ck 2 other than specific PM hardware is powered off). 

0x0002 B4/bl suspend. support Hardware supports a mode in which all but main memory is powered 
off. Firmware supports resume from this state. 

0x0004 B4/b2 LID_support Interrupts are presented when a lid (portable systems) is opened or 
closed so that a PM system can take appropriate action. 

0x0008 B4/b3 battery support The system is capable of running off a battery and there are battery 
power management capabilities inplemented (system dependent). 

0x0010 B4/b4 ringing resume from hibernation Modem ring can trigger resume from hibernation. 

0x0020 B4/b5 ringing resume from suspend Modem ring can trigger resume from suspend. 
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Table 7. Power Management Attributes 





PMattribute Byte/bit 


Name 


resume_from_hibernation_at_spe 


Description 























0x0040 B4/b6 Re 5 An alarm can be set to trigger resume from hibernation. 
cified time 
0x0080 B4/b7 Tr An alarm can be set to trigger resume from suspend. 
0x0100 B5/b0 hibernation from. suspend. at. spe An alarm can be set to trigger a change from suspended state to a hiber- 
cified time nated state.. 
software controllable main pow The main power switch does not directly turn on/off power to the sys- 
0x0200 B5/bl : Pee 
er_switch tem, but is visible to the software. 
0x0400 B5/b2 general_purpose_input_pin_for_r Some other input can trigger resume. 
esume_trigger 
Fail ocak hardware målt poet If a software controllable main power switch is implemented, there is a 
0x0800 B5/b3 ale in P = hardware mechanism to manually turn on/off power should the soft- 
off_switch å 
ware mechanism fail. 
0x1000 B5/b4 resume button support There is a button that can trigger the hardware to resume. 
0x2000 B5/b5 inhibit auto transition Automatic transistion between PM states is inhibited. 





#tifndef PMSPTPNP 
#define PMSPTPNP 


#define PMsupport Packet 0x84 /* tag for PMsupportPack */ 
typedef enum PM attribute ( 
hibernation support = 0x0001, 
suspend suppport = 0x0002, 
LID support = 0x0004, 
battery support = 0x0008, 
ringing resume from hibernation = 0x0010, 
ringing resume from suspend = 0x0020, 
resume from hibernation at specified time = 0x0040, 
resume from suspend at specified time = 0x0080, 
hibernation from suspend at specified time = 0x0100, 
software controllable main power switch = 0x0200, 


general purpose input pin for resume trigger = 0x0400, 





fail safe hardware main power off switch = 0x0800, 





resume button support = 0x1000, 
inhibit auto transition = 0x2000 
} PM attribute; 


typedef struct PMsupportPack ( 


unsigned 
unsigned 
unsigned 
unsigned 
unsigned 


char 
char 
char 
char 
long 


Tag; 

Count 0; 
Counti; 
Type; 
PMattribute; 


} PMsupportPack; 


#endif /* ndef _PMSPTPNP_ */ 


/* 
/* 
/* 
/* 


large tag = 0x84 Vendor specific */ 


= 0x05 sizeof (PMsupprtPack) -3 */ 
= 0 */ 
= 8 (PM Controller) */ 
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1.6.2.9 Type=0x09: Generic Address 





This descriptor permits specification of addresses beyond what is provided by the standard PnP address 
tags. See the header file GENADRPNP.H (below) for details. 
e Byte 5: AddrInfo is the number of bits decoded by the hardware for this range of addresses. 


* Byte 8: Address[0] is base address bits(7:0), etc., little-endian byte ordering within the doubleword 
represented by Address[8] (bytes 8-15). The same holds true for Length[8]. 


#ifndef _GENADPNP_ 
#tdefine _GENADPNP_ 


typedef enum AddrType { 


ISAIOAddr = 1, /* ISA/PCI I/O address */ 

IOMemAddr = 2, /* I/O Memory address space */ 

SysMemAddr = 3 /* System memory address */ 
) AddrType; 


typedef struct GenericAddr { 





unsigned char Tag; /* large tag = 0x84 Vendor specific */ 
unsigned char Count0; /* lo byte of count */ 
unsigned char Count1; /* hi byte of count */ 

/* count = sizeof( Genericaddr) - 3 */ 
unsigned char Type; /* = 9 (Generic Address) */ 
unsigned char AddrType; /* see enum AddrType */ 
unsigned char Addrinfo; /* info for the AddrType */ 

/* I/O address type: number of bits */ 
unsigned char Reserved[2]; /* reserved */ 
unsigned char Address [8] ; /* Address */ 
unsigned char Length[8]; /* Number of contiguous bytes used */ 


) Genericaddr; 


Hendif /* ndef GENADPNP */ 


1.6.2.10 Type=0x0A: ISA Bridge Information 


This tag describes how ISA interrupts are mapped to system interrupts. See the header file ISAPNP.H 
(below) for details. 


* Byte 5: IntCtrINumber is provided to support the RS/6000 interrupt structure which needs to specify 
a BUID. 


e Bytes 6&7: Int[0] is a two byte representation of the system interrupt to which IRQO is mapped - in 
little-endian byte ordering within the halfword (bytes 6&7). Byte 6 is “system interrupt number” 
bits(7:0); byte 7 is “system interrupt number” bits(15:8).The same holds true for Int[1 thru 
MAX_ISA_INTS]. 


#ifndef _ISAPNP_ 
#define _ISAPNP_ 


#tdefine MAX ISA INTS 16 
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typedef struct _ISAInfoPack { 


unsigned 
unsigned 
unsigned 


unsigned 
unsigned 


unsigned 


unsigned 


C 
C 
c. 


nar 
nar 
nar 


nar 
nar 


nar 





hort 


) ISAInfoPack; 


Hendif 


rag; 


lype; 





Count 0; 
Count1; 


ntCtrlType; 


nt CtrlNumber; 


/* ndef ISAPNP */ 


/* 
/* 
/* 
/* 
/* 
/* 
/* 
/* 
/* 
/* 
/* 


nt [MAX ISA INTS]; /* 


/* 
/* 
/* 
/* 


1.6.2.11 Type=0x0B: Video Channels 


This descriptor gives characteristics of video capture support. See the header file VIDCHPNP.H 


(below) for details. 


/* 
/* 
/* 
/* 
/* 


large tag = 0x84 Vendor s 
lo byte of count 
hi byte of count 


specific 


count = sizeof(_ISAInfoPack) - 3 


= Ox0A (ISA bridge) 
Interrupt controller type 
enum IntTypes in pcipnp. 


h 


Interrupt controller number 


0 8259 interrupt 
0 MPIC interrupt 
buid RS6K interrupt 
Interrupt mapping table 
index 0 for IRQO 
index 1 for IRQL 
index 15 for IRQ15 
OxFFFF if not usable 


If this packet is not available on a system with a G10 video capture 


card installed, 
developer's kit). 


assume WOODFIELD 


(ThinkPad Power Series 850 - M/T 6020 
If this packet is not available on a system without a 


G10 video capture card, assume no video channels are available except for 
VGA graphics. 


Hifndef _VIDCHPNP_ 
#define _VIDCHPNP_ 


/* 
/* 
/* 
/* 
/* 
/* 
/* 
/* 
/* 
/* 
/* 


typedef enum PhysicalChannelID { 


Physical Video Channel ID definitions 
Note that a physical channel may have more than one logical channel. For 


example, 
example, 


At this moment, 


a video input channel can be used for NTSC and PAL. 


In another 


a video channel can be used for composite video and S-video. 


video chips. 


controller types and the lower 4 bits represent controller-dependent video 


channel names. 


registered at this revision. 


Extension 


vibdo Y 
vido C 
viD1 Y 
VviD1 C 
viD2 Y 
viD2 C 
viD3 Y 
viD3 C 
VoR 
VoG 
VoB 
Extension 


only Brooktree Bt812 and ASCII V7310A are the available 


Originator’s intention is that the upper 4 bits represent 


But, 


for flexibility, 
It may be applied in the future. 
= OXFF is reserved for future uses. 


0x00, 
0x01, 
0x02, 
0x03, 
0x04, 
0x05, 
0x06, 
0x07, 
0x10, 
0x11, 
0x12, 
OxFF, 


/* 
/* 
/* 
/* 
/* 
/* 
/* 
/* 
/* 
/* 
/* 
/* 


the above guideline is not 


Bt812 ViDO Y 
Bt812 ViDO C 
Bt812 ViD1 Y 
Bt812 ViD1 C 
Bt812 ViD2 Y 
Bt812 ViD2 C 
Bt812 ViD3 Y 
Bt812 ViD3 C 
V7310A VOR 
V7310A VoG 
V7310A VoB 
Reserved for future use 





Note that 


ay 
sf 
kl 
xy 
ay 
sal 
*/ 
kar 
EN 
Bf 
Sy 
EN 
ay 
#7: 
+y 
sf 


ke 
KV 
*/ 
*/ 
*/ 


å 
*/ 
*/ 
ay 
*/ 
*/ 
2y 
kr 
*/ 
* 
å 


*/ 
*/ 
*/ 
*/ 
*/ 
*/ 
*/ 
kl 
*/ 
Kr 
kr 
*/ 
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) PhysicalChannelID; 


typedef enum ConnectorType { 


RCAJack = 0x00, /* RCA Jack (1-pin) */ 
MiniDIN = 0x01, /* Mini DIN Connector (4-pin) */ 
BNC = 0x02, /* BNC Coaxial Connector */ 
VGADSub = 0x03, /* VGA D-Sub Connector (15-pin) */ 
T6040Camera = 0x04, /* WOODFIELD Camera Connector */ 
InternalConnection = OxFE, /* No external connectors */ 
Not Connected = OxFF, /* No connection at all */ 


} ConnectorType; 


typedef enum SignalType { 








NTSCComposite = 0x00, /* NTSC Composite Video */ 
NTSCLume = 0x01, /* NTSC S-Video Luma */ 
NTSCChroma = 0x02, /* NTSC S-Video Chroma */ 
NTSCY = 0x03, /* NTSC Component Y */ 
NTSCYR = 0x04, /* NTSC Component Y-R */ 
NTSCYB = 0x05, /* NTSC Component Y-B */ 
NTSCTimingOnly = 0x06, /* NTSC Timing Only */ 
NTSCDiagnostics = 0x07, /* NTSC Wrap-back */ 
PALComposite = 0x10, /* PAL Composite Video */ 
PALLume = 0x11, /* PAL S-Video Luma */ 
PALChroma = 0x12, /* PAL S-Video Chroma */ 
PALY = 0x13, /* PAL Component Y */ 
PALYR = 0x14, /* PAL Component Y-R */ 
PALYB = Ox15, /* PAL Component Y-B */ 
PALTimingOnly = 0x16, /* PAL Timing Only */ 
PALDiagnostics =. 0X17; /* PAL Wrap-back */ 
SECAMComposite = 0x20, /* SECAM Composite Video */ 
SECAMLume = 0x21, /* SECAM S-Video Luma */ 
SECAMChroma = 0x22, /* SECAM S-Video Chroma */ 
SECAMY = 0x23, /* SECAM Component Y */ 
SECAMYR = 0x24, /* SECAM Component Y-R */ 
SECAMYB = 0x25, /* SECAM Component Y-B */ 
SECAMTimingOnly = 0x26, /* SECAM Timing Only */ 
SECAMDiagnostics = 0x27, /* SECAM Wrap-back */ 
VGARed = 0x30, /* VGA Red */ 
VGAGreen = 0x31, /* VGA Green */ 
VGABlue = 0x32, /* VGA Blue */ 
NoSignal = OxFF, /* No Signal */ 
} SignalType; 
typedef struct VidChanMap { /* Video Channel Map */ 
unsigned char LogocialChannelID; /* Video Channel = 0, 1, ... n */ 
unsigned char VideolIO; /* 0 : In, 1 : Out */ 
/* Note that a single physical channel */ 
/* may support both video-in and */ 
/* video-out future implementations. */ 
/* Under such circumstances, separate */ 
/* logical channel IDs must be */ 
/* assigned. */ 
unsigned char PhysicalChannelID; /* Controller dependent port ID */ 
unsigned char ConnectorType; /* Mechanical Connector Type */ 
unsigned char SignalType; /* Electrical Signal Type */ 





} VidChanMap; 


typedef struct _VidChanInfoPack ( 





unsigned char Tag; /* large tag = 0x84 Vendor specific */ 
unsigned char Count0; /* lo byte of count */ 
unsigned char Count1; /* hi byte of count */ 
/* count = number of logical video channels * sizeof(VidChanMap) + 1 */ 
unsigned char Type; /* =B */ 
VidChanMap VCMap [1]; /* Video channel map */ 
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ie */ 


} VidChanInfoPack; 


#endif /* ndef _VIDCHPNP_ */ 


1.6.2.12 


Type=0x0C: Power Control 


This descriptor lists power control capabilities. See the header file PCSPTPNP.H (below) for details. 


#ifndef __ 
#define _ 


#define 


PCSPTPNP _ 
PCSPTPNP _ 


PCsupport Packet 0x84 /* tag for PCsupportPack */ 


typedef enum PC attribute ( 


program power off support 


0x0001, 


program power on support = 0x0002 
] PC attribute; 


typedef struct PCsupportPack ( 


unsigned char Tag; /* large tag = 0x84 Vendor specific */ 
unsigned char Count0; /* = 0x05 sizeof (PCsupprtPack) -3 */ 
unsigned char Count1; /* = 0 */ 
unsigned char Type; /* = 0x0C (PC Controller) */ 


unsigned long PCattribute; 
} PCsupportPack; 


#endif /* ndef PCSPTPNP */ 


1.6.2.13 


Type=0x0D: Memory SIMM PD Data 


This descriptor gives SIMM presence detect data. There is one byte of PD data per SIMM connected to 
the memory controller listing this descriptor; the meaning of the bits within the byte is system specific. 
See the header file MEMPDPNP.H (below) for details. 


Hifndef _MEMPDPNP 


#define _MEMPDPNP 

#define MemPD Packet 0x84 

typedef struct _MemPDPack { 
unsigned char Tag; /* large tag = 0x84 Vendor specific */ 
unsigned char CountO0; /* lo byte of count */ 
unsigned char Countl; /* hi byte of count */ 
unsigned char Type; /* = OxD (Memory SIMM PD Descriptor) */ 
unsigned char PDBits[1]; /* array for SIMM PD bytes */ 
// SIMM PD info notes: 
// 1. The actual runtime length, n, of the PDBits array is 
{1 n = RESIDUAL.VitalProductData.NumSIMMSlots * Banks 
// 2. For Victory products, Banks = 1 
// 3. A value of OxFF for PDBits[m] indicates SIMM slot m does not contain 
{1 a SIMM (m refers to logical, zero based SIMM slot numbers. it does 
// not imply that the number on or next to the SIMM connector has the 
// same value. this file does not define the physical SIMM numbering) 


) MemPDPack ; 
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#endif 


1.6.2.14 Type=0x0E: System Interrupts 


This descriptor can be attached to a device to specifiy an interrupt not connected to an AT-style interrupt 
tree (use PnP small resource item IRQ format for AT interrupts). See the header file SINTPNP.H 
(below) for details. IntCtrIType and IntCtrINumber contain values as in ISAPNP.H. 


#ifndef _SINTPNP_ 
#define _SINTPNP_ 
#define SINT Packet 0x84 





typedef struct SysIntPack { 


unsigned char Tag; 

unsigned char Count0; 
unsigned char Countl; 
unsigned char Type; 

unsigned char IntCtrlType; 
unsigned char IntCtrlNumber; 
unsigned char Int[2]; 


} SysInt Pack; 


#endif 


1.6.2.15 Type=0x0F: Error Log 


/* 
/* 
/* 
/* 
/* 
/* 
/* 
/* 
/* 
/* 
/* 
/* 





large tag = 0x84 Vendor specific */ 
lo byte of count */ 
hi byte of count */ 

count = sizeof(SysIntPack) - 3 */ 
= OxE (System Interrupt Descriptor) */ 
nterrupt controller type */ 
Interrupt controller number */ 
Interrupt number */ 
nt [0] = bits[7:0] Kf 
nt [1] = bits[15:8] */ 
high order bit (bit 15) info: */ 
1 => edge sensitive; 0 => level */ 


This descriptor provides for an error log embedded in the DevicePnPHeap. See the header file 


ERRLGPNP.H (below) for details. 


#ifndef ERRLGPNP 
#define ERRLGPNP 


#define RAMErrorLog Packet 0x84 


typedef struct RAMErrorLogPack { 











unsigned char Tag; /* large tag = 0x84 Vendor specific */ 
unsigned char Count0; /* lo byte of count */ 
unsigned char Countl; /* hi byte of count */ 
unsigned char Type; /* = OxF (RAM Error Log Descriptor) */ 
unsigned char =ErrLog [1]; /* array for Error Log bytes */ 
// Error Log notes: 

// 1. This error log is present if and only if 

{7 RESIDUAL. VitalProductData.RAMErrorLogOffset != NULL 

// 2. If present, this log is on the PNP heap at location 

if RESIDUAL. DevicePnPHeap [RESIDUAL. Vital ProductData. RAMErrorLogOf fset] 

// 3. This error log is a duplicate of the nvram error log with the 

// following difference: it is cleared at the beginning of each system 

// boot. Hence, unlike the nvram error log, the first error in this log 
Tf will be the first error for the current boot. The second entry will 
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// 


be the last error, in the same manner as the nvram error log 


) RAMErrorLogPack ; 


#endif 


1.6.2.16 Type=0x10: Extended VPD 


This descriptor provides for extended vital product data embedded in the DevicePnPHeap. See the 


header file EXVPDPNP.H (below) for details. 





#ifndef _EXVPDPNP 
#define _EXVPDPNP 
#define ExtVPD_Packet 0x84 
typedef struct _ExtVPDPack { 
unsigned char Tag; /* large tag = 0x84 Vendor specific 
unsigned char Count0; /* lo byte of count 
unsigned char Countl; /* hi byte of count 
unsigned char Type; /* = 0x10 (Extended VPD Descriptor) 
unsigned char vpd_start; /* undefined 
unsigned char Flag[3]; /* contains "VPD" in ascii format 
/* see the notes below for detailed 
/* info on the following fields 
unsigned char LenHI; /* length (high byte) of data below 
unsigned char LenLO; /* length (low byte) of data below 
unsigned char NextOffsetHI; /* offset to the next VPD block, a 0 
unsigned char NextOffsetLO; /* value indicates no more blocks 
unsigned char VPDBlockData[1]; /* array for Extended VPD 


// Extended VPD notes: 


// 1. 


This PNP structure contains an array of VPD data, herein referred to 
as "extended VPD". Extended in the sense that a service processor is 
required to extract the VPD from various "extended locations" within 
the system hardware (e.g., from the io planar, the processor card, 
the service processor itself, etc). If more than one extended VPD 
block is present, each one will be encapsulated in one of these PNP 
structures, with each structure catenated to the previous structure 
as explained inherently from the notes below. The extended VPD block 
begins at the "vpd_start" field of each present PNP structure. 

The first location of each VPD block will begin with its own 

"vypd start" field (followed by its own Flag[], LenHI, .. etc). The 
"NextOffsetHI/LO" value indicates if additional VPD Blocks are 
present. A value of 0 defines the current block as the last. If the 
value is non-zero, the beginning "vpd_start" field of the next block 
will be "NextOffsetHI/LO" bytes from the current "vpd start" field 
location. 
The "LenHI/LO" field is the length of the data for the current 
block, beginning with the VPDBlockData[0] byte of the current Block. 
WARNING: The unit value of this field represents two bytes. Hence, 
the total length of the current block data array field, in bytes, 

is two times "LenHI/LO". 

Extended VPD data will be present if and only if 
RESIDUAL.VitalProductData.ExtendedVPD != NULL in which case 
RESIDUAL .DevicePnPHeap [RESIDUAL .VitalProductData .ExtendedVPD] 

is the "vpd_start" field of the first VPD data block. 








The data array (ExtVPDBlockData[]) contains data in the format of 
the RISC/6000 system VPD. E.G., "*XYLenSpecific-data". The asterisk 
is always present at the beginning of each field. XY represents an 
ASCII alphanumeric sequence of two characters that describe the 
"Specific-data" field. Len is a one byte unsigned field representing 
the total length of the data field, beginning with the * and ending 
with the last byte of the Specific-data, divided by two. In other 
words, the total length of the field is "Len" two-byte words. 2 is 
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// the minimum value for Len (in which case there is no Specific-data) . 
// Except for the "Len" field byte, which is in binary, all other bytes 
// are in ASCII. 

// 

// Asside note: 

// The complete compliment of VPD can be obtained without any knowledge 
// of PNP format. Notes 4 & 2 tell how to get to the first VPD block 

// and how to find any additional VPD blocks, note 5 gives the format 
// of the VPD in each VPD block, and note 3 gives the length of each 

Jd VPD block. The rest of the fields, e.g. Tag, Count0, and Countl, 

// conform to PNP specifications not defined in this header file, and 
// may be ignored if all one needs is to extact the extended VPD. 


} ExtVPDPack ; 


#endif 


1.6.2.17 Type=0x11: Timebase Control 


This descriptor specifies the register address and bit that is used to enable/disable the timebase. See the 
header file TBCTLPNP.H (below) for details. 


/* 10/10/95 */ 
/* Structure map for Timebase Control */ 
/* See Plug and Play ISA Specification, Version 1.0a, March 24, 1994. */ 
/* It (or later versions) is available on Compuserve in the PLUGPLAY */ 
/* area. This code has extensions to that specification, namely new */ 
/* short and long tag types for platform dependent information */ 
/* Warning: LE notation used throughout this file */ 


Hifndef TBCTLPNP 
#define TBCTLPNP 


#define TBCtl_Packet 0x84 


/* This packet specifies the register address and bit that is used to 
enable/disable the timebase. */ 


typedef struct _TBCtlPack { 








unsigned char Tag; /* large tag = 0x84 Vendor Specific */ 
unsigned char Count0; /* lo byte of count = 0xD */ 
unsigned char Count1; /* hi byte of count = 0x0 */ 
unsigned char Type; /* = 0x11 (Timebase Control) */ 
unsigned char TBCtlBit; /* The bit number (in HEX) in the */ 
/* register at TBCtlAddr that */ 
/* enables/disables the Timebase. */ 
/* Bit 0 is low order (2**0). */ 
unsigned char TBEnable; /* The boolean state of TBCtlBit that */ 
/* means "enable" (0x0 or 0x1) */ 
unsigned char Reserved[2]; /* set to 0x0 */ 
unsigned char TBCtlAddr[8] ; /* The address of the register */ 
/* containing the Timebase */ 
/* enable/disable bit. */ 
} TBCtlPack; 





#endif 
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residual.h 


/* 5/04/95 
{*ž------------------------------------------------------------ 
/* Residual Data header definitions and prototypes 
{*------------------------------------------------------------ 


/* Structure map for RESIDUAL on PowerPC Reference Platform 
/* residual.h - Residual data structure passed in r3. 


/* Load point passed in r4 to boot image. 
/* For enum’s: if given in hex then they are bit significant, 
/* i.e. only one bit is on for each enum 


/* Reserved fields must be filled with zeros. 


#ifndef RESIDUAL 
#define _RESIDUAL 





Appendix A 


*/ 
rosea eta See Si */ 
*/ 
EET NE PK eg ene */ 


* 
kr 
*/ 
* 
*/ 
*/ 


#define MAX CPUS 32 /* These should be set to the maximum */ 
#define MAX MEMS 64 /* number possible for this system. */ 
#define MAX DEVICES 256 /* Changing these will change the */ 
#define AVE PNP SIZE 32 /* structure, hence the version of */ 
#define MAX MEM SEGS 64 /* this header file. */ 
/* EEE EE EEE Sea teesee ee sec lee ececs ee EN EEE en */ 
/* Public structures */ 
/* WS EE EE SES BES a Gk eS Å en EE Eye a ge ye a */ 


#include “pnp.h” 


typedef enum L1CACHE TYPE { 
NoneCAC = 0, 
Splitcac = 1, 
CombinedCAC = 2 
} L1CACHE TYPE; 


typedef enum TLB TYPE { 
NoneTLB = 0, 
SplitTLB = 1, 
CombinedTLB = 2 
} TLB_TYPE; 


typedef enum FIRMWARE SUPPORT { 


Conventional = 0x01, 
OpenFirmware = 0x02, 
Diagnostics = 0x04, 
LowDebug = 0x08, 
Multiboot = 0x10, 
LowClient = 0x20, 
Hex41 = 0x40, 

FAT = 0x80, 
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509660 = 0x0100, 

SCSI InitiatorID Override = 0x0200, 
Tape Boot = 0x0400, 

FW Boot Path = 0x0800 

} FIRMWARE SUPPORT; 


typedef enum _FIRMWARE SUPPLIERS { 





BMFirmware = 0x00, 
MotoFirmware = 0x01, 
FirmWorks = 0x02, 


Bull = 0x03, 
} FIRMWARE SUPPLIERS; 


typedef enum _ENDIAN_SWITCH_METHODS { 
UsePort92 = 0x01, 
UsePCIConfigA8 = 0x02, 
UseFF001030 = 0x03, 
} ENDIAN SWITCH METHODS; 


typedef enum SPREAD IO METHODS { 
UsePort850 = 0x00, 
/*UsePCIConfigA8 = 0x02,*/ 
} SPREAD IO METHODS; 


typedef struct _VPD { 


/* Box dependent stuff */ 
unsigned char PrintableModel [32] ; /* Null terminated string. 
Must be of the form: 
vvv,<20h>,<model designation>,<0x0> 
where vvv is the vendor ID 
e.g. IBM PPS MODEL 6015<0x0> */ 
unsigned char Serial[16]; /* 12/94: 
Serial Number; must be of the form: 
vvv<serial number> where vvv is the 
vendor ID. 











e.g. IBM60151234567<20h><20h> */ 
unsigned char Reserved[48] ; 
unsigned long FirmwareSupplier; /* See FirmwareSuppliers enum */ 
unsigned long FirmwareSupports; /* See FirmwareSupport enum */ 
unsigned long NvramSize; /* Size of nvram in bytes */ 
unsigned long NumSIMMSlots; 
unsigned short EndianSwitchMethod; /* See EndianSwitchMethods enum */ 
unsigned short SpreadIOMethod; /* See SpreadIOMethods enum */ 
unsigned long SmpIar; 
unsigned long RAMErrorLogOffset; /* Heap offset to error log */ 
unsigned long Reserved5; 
unsigned long Reserved6; 
unsigned long ProcessorHz; /* Processor clock frequency in Hertz */ 
unsigned long ProcessorBusHz; /* Processor bus clock frequency */ 
unsigned long Reserved7; 
unsigned long TimeBaseDivisor; /* (Bus clocks per timebase tic) *1000 */ 
unsigned long WordWidth; /* Word width in bits */ 
unsigned long PageSize; /* Page size in bytes */ 
unsigned long CoherenceBlockSize; /* Unit of transfer in/out of cache 
for which coherency is maintained; 
normally <= CacheLineSize. */ 
unsigned long GranuleSize; /* Unit of lock allocation to avoid */ 
/* false sharing of locks. */ 
/* L1 Cache variables */ 
unsigned long CacheSize; /* L1 Cache size in KB. This is the */ 
/* total size of the L1, whether */ 
/* combined or split */ 
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unsigned long 
unsigned long 


unsigned long 


/* For split L 
unsigned long 
unsigned long 
unsigned long 
unsigned long 
unsigned long 
unsigned long 


CacheAttrib; 
CacheAssoc; 


CacheLineSize; 


1 Cache: 
I_CacheSize; 
I_CacheAssocj; 


I_CacheLineSize; 


D_CacheSize; 
D CacheaAssoc; 
D Cac 





heLineSize; 


/* LICACHE TYPE */ 
/* L1 Cache associativity. Use this 
for combined cache. If split, put 
zeros here. */ 
/* L1 Cache line size in bytes. Use 
for combined cache. If split, put 
zeros here. */ 


(= combined if combined cache) */ 


/* Translation Lookaside Buffer variables */ 


unsigned long 
unsigned long 
unsigned long 


/* For split T 
unsigned long 
unsigned long 
unsigned long 
unsigned long 





unsigned long 
) VPD; 


typedef enum DE 
Enabled = 0x40 
Integrated = 0 
Failed = 0x100 
Static = 0x080 


Dock 0x0400, 


Boot = 0x0200, 


Configurable = 
Disableable = 

PowerManaged = 
ReadOnly = 0x2 





TLBSize; /* Total number of TLBs on the system */ 

TLBAttrib; /* Combined I+D or split TLB */ 

TLBAssoc; /* TLB Associativity. Use this for 
combined TLB. If split, put zeros 
here. */ 

LB: (= combined if combined TLB) */ 

I_TLBSize; 

I_TLBAssoc; 

D TLBSize; 

D_TLBAssoc; 

ExtendedVPD; /* Offset to extended VPD area; 


VICE FLAGS { 
00, 

x2000, 

0, 

0, 


0x0100, 
0x80, 

0x40, 
0, 


Removable = 0x10, 
ConsoleIn = 0x08, 


ConsoleOut = 0 
Input = 0x02, 
Output = 0x01 
} DEVICE FLAGS 





x04, 


i 


typedef enum BUS ID ( 
ISADEVICE = 0x01, 


EISADEVICE = 0. 


x02, 


PCIDEVICE = 0x04, 


PCMCIADEVICE = 
PNPISADEVICE = 


0x08, 
0x10, 


MCADEVICE = 0x20, 


MXDEVICE = 0x4 


0, 


PROCESSORDEVICE = 0x80, 
VMEDEVICE = 0x100, 





} BUS_ID; 





null if unused */ 

/* - PCI device is enabled */ 
/* - device failed POST code tests */ 
/* 0 - dynamically configurable 

- static */ 
/* 0 - not a docking station device 

- is a docking station device */ 
/* 0 - device cannot be used for BOOT 

- can be a BOOT device */ 
/* - device is configurable */ 
/* - device can be disabled */ 
/* 0 - not managed; 1 - managed */ 
/* - device is read only */ 
/* - device is removable */ 
/* Devices on mezzanine bus */ 
/* Devices on processor bus */ 
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typedef struct DEVICE ID { 





unsigned long BusId; /* See BUS_ID enum above */ 
unsigned long DevId; /* Big Endian format */ 
unsigned long SerialNum; /* For multiple usage of a single 

DevId */ 
unsigned long Flags; /* See DEVICE FLAGS enum above */ 
unsigned char BaseType; /* See pnp.h for bit definitions */ 
unsigned char SubType; /* See pnp.h for bit definitions */ 
unsigned char Interface; /* See pnp.h for bit definitions */ 


unsigned char Spare; 
) DEVICE ID; 


typedef union BUS ACCESS { 
struct _PnPAccess{ 
unsigned char CSN; 
unsigned char LogicalDevNumber ; 
unsigned short ReadDataPort; 
} PnPAccess; 
struct _ISAAccess{ 
unsigned char SlotNumber; /* ISA Slot Number generally not 
available; 0 if unknown */ 
unsigned char LogicalDevNumber; 
unsigned short ISAReserved; 
) ISAAccess; 
struct _MCAAccess{ 
unsigned char SlotNumber; 
unsigned char LogicalDevNumber; 
unsigned short MCAReserved; 
) MCAAccess; 
struct _PCMCIAAccess{ 
unsigned char SlotNumber; 
unsigned char LogicalDevNumber; 
unsigned short PCMCIAReserved; 
) PCMCIAAccess; 
struct _EISAAccess{ 
unsigned char SlotNumber; 
unsigned char FunctionNumber; 
unsigned short EISAReserved; 
} EISAAccess; 
struct _PCIAccess 
unsigned char BusNumber; 
unsigned char DevFuncNumber; 
unsigned short PCIReserved; 
} PCIAccess; 
struct _ProcBusAccess { 
unsigned char BusNumber; 
unsigned char BUID; 
unsigned short ProcBusReserved; 
) ProcBusAccess; 
} BUS_ACCESS; 











/* Per logical device information */ 
typedef struct PPC DEVICE { 
DEVICE ID DevicelId; 
BUS ACCESS BusAccess; 


/* The following three are offsets into the DevicePnPHeap */ 


/* All are in PnP compressed format */ 

unsigned long AllocatedOffset; /* Allocated resource description */ 
unsigned long PossibleOffset; /* Possible resource description */ 
unsigned long CompatibleOffset; /* Compatible device identifiers */ 


) PPC DEVICE; 
typedef enum CPU STATE ( 
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CPU_GOOD = 0, /* CPU is present, and active */ 
CPU GOOD FW = 1, /* CPU is present, and in firmware */ 
CPU OFF = 2, /* CPU is present, but inactive */ 
CPU FAILED = 3 /* CPU is present, but failed POST */ 
CPU NOT PRESENT = 255 /* CPU not present */ 


) CPU STATE; 


typedef struct PPC CPU ( 





unsigned long CpuType; /* Result of mfspr from Processor 
Version Register (PVR). 
PVR(0-15) = Version (e.g. 601) 
PVR(16-31 = EC Level */ 
unsigned char CpuNumber; /* CPU Number for this processor */ 
unsigned char CpuState; /* CPU State, see CPU STATE enum */ 
unsigned short Reserved; 
) PPC CPU; 
typedef struct PPC MEM ( 
unsigned long SIMMSize; /* 0 - absent or bad 
8M, 32M (in MB) */ 
) PPC MEM; 
typedef enum MEM USAGE ( 
Other = 0x8000, 
ResumeBlock = 0x4000, /* for use by power management */ 
SystemROM = 0x2000, /* Flash memory (populated) */ 
UnPopSystemROM = 0x1000, /* Unpopulated part of SystemROM area */ 
OMemory = 0x0800, 
SystemIO = 0x0400, 
SystemRegs = 0x0200, 
PCIAddr = 0x0100, 
PCIConfig = 0x80, 
SAAddr = 0x40, 
Unpopulated = 0x20, /* Unpopulated part of System Memory */ 
Free = 0x10, /* Free part of System Memory */ 
Boot Image = 0x08, /* BootImage part of System Memory */ 
FirmwareCode = 0x04, /* FirmwareCode part of System Memory */ 
FirmwareHeap = 0x02, /* FirmwareHeap part of System Memory */ 
FirmwareStack = 0x01 /* FirmwareStack part of System Memory*/ 
} MEM USAGE; 
typedef struct _MEM MAP { 
unsigned long Usage; /* See MEM_USAGE above */ 
unsigned long BasePage; /* Page number measured in 4KB pages */ 
unsigned long PageCount; /* Page count measured in 4KB pages */ 
} MEM MAP; 
typedef struct _RESIDUAL { 
unsigned long ResidualLength; /* Length of Residual */ 
unsigned char Version; /* of this data structure */ 
unsigned char Revision; /* of this data structure */ 
unsigned short EC; /* of this data structure */ 
/* VPD */ 
VPD VitalProductData; 
/* CPU */ 
unsigned short MaxNumCpus; /* Max CPUs in this system */ 
unsigned short ActualNumCpus; /* ActualNumCpus < MaxNumCpus means */ 
/* that there are unpopulated or */ 
/* otherwise unusable cpu locations */ 
PPC CPU Cpus [MAX CPUS] ; 
/* Memory */ 
unsigned long TotalMemory; /* Total amount of memory installed */ 
unsigned long GoodMemory; /* Total amount of good memory */ 


unsigned long ActualNumMemSegs ; 
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MEM MAP Segs[MAX MEM SEGS] ; 
unsigned long ActualNumMemories; 
PPC MEM Memories [MAX MEMS] ; 

/* Devices */ 

unsigned long ActualNumDevices; 
PPC DEVICE Devices [MAX DEVICES] ; 


unsigned char DevicePnPHeap[2*MAX DEVICES*AVE_PNP_SIZE] ; 
} RESIDUAL; 


Hendif /* ndef RESIDUAL */ 
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pnp.h Appendix B 


/* 5/18/95 */ 
/* ASS Se ee See ee See ie Se Se oe ee eee Se ee ea ee ee ee ae eee ee eS */ 
/* Plug and Play header definitions */ 
/* oe k EN ETE EE SPT a FE NE NE ee Ne ee a E */ 
/* Structure map for PnP on PowerPC Reference Platform */ 
/* See Plug and Play ISA Specification, Version 1.0, May 28, 1993. It */ 
/* (or later versions) is available on Compuserve in the PLUGPLAY area. */ 
/* This code has extensions to that specification, namely new short and */ 
/* long tag types for platform dependent information */ 
/* Warning: LE notation used throughout this file */ 
/* For enum's: if given in hex then they are bit significant, i.e. */ 
/* only one bit is on for each enum */ 


ifndef PNP 
define PNP 


define MAX MEM REGISTERS 9 
define MAX IO PORTS 20 
define MAX IRQS 7 

define MAX DMA CHANNELS 7 


/* Interrupt controllers */ 








define PNPinterruptO "PNP0000” /* AT Interrupt Controller */ 
define PNPinterruptl “PNP0001” /* EISA Interrupt Controller */ 
define PNPinterrupt2 "PNP0002" /* MCA Interrupt Controller */ 
define PNPinterrupt3 “PNP0003” /* APIC */ 
define PNPExtInt "IBMOOO0D” /* PowerPC Extended Interrupt Controller */ 


/* Timers */ 


define PNPtimer0 “PNPO100” /* AT Timer */ 
define PNPtimerl “PNPO101” /* EISA Timer */ 
define PNPtimer2 "PNP0102" /* MCA Timer */ 


/* DMA controllers */ 





define PNPdma0 "PNP0200" /* AT DMA Controller */ 
define PNPdmal "PNP0201" /* EISA DMA Controller */ 
define PNPdma2 "PNP0202" /* MCA DMA Controller */ 


/* start of August 15, 1994 additions */ 
/* CMOS */ 
define PNPCMOS "IBMO009” /* CMOS */ 
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/* L2 Cache */ 
#define PNPL2 “IBMO0007” /* L2 Cache */ 


/* NVRAM */ 
Hdefine PNPNVRAM "IBMO008” /* NVRAM */ 


/* Power Management */ 
#define PNPPM "IBMO005” /* Power Management */ 
/* end of August 15, 1994 additions */ 


/* Keyboards */ 


define PNPkeyboardO “PNP0300” /* IBM PC/XT KB Cntlr (83 key, no mouse) */ 
define PNPkeyboardl “PNP0301” /* Olivetti ICO (102 key) */ 
define PNPkeyboard2 “PNP0302” /* IBM PC/AT KB Cntlr (84 key) */ 
define PNPkeyboard3 “PNP0303” /* IBM Enhanced (101/2 key, PS/2 mouse) */ 
define PNPkeyboard4 “PNP0304” /* Nokia 1050 KB Cntlr */ 
define PNPkeyboard5 “PNP0305” /* Nokia 9140 KB Cntlr */ 
define PNPkeyboard6 “PNP0306” /* Standard Japanese KB Cntlr */ 
define PNPkeyboard7 “PNP0307” /* Microsoft Windows (R) KB Cntlr */ 


/* Parallel port controllers */ 


define PNPparallelO “PNP0400” /* Standard LPT Parallel Port */ 
define PNPparallell "PNP0401” /* ECP Parallel Port */ 
define PNPepp "IBMO01C” /* EPP Parallel Port */ 


/* Serial port controllers */ 


define PNPserialOQ “PNP0500” /* Standard PC Serial port */ 
define PNPSeriall "PNP0501" /* 16550A Compatible Serial port */ 














/* Disk controllers */ 














define PNPdiskO0 “PNP0600” /* Generic ESDI/IDE/ATA Compat HD Cntlr */ 
define PNPdisk1 “PNP0601” /* Plus Hardcard II */ 
define PNPdisk2 “PNP0602” /* Plus Hardcard IIXL/EZ */ 


/* Diskette controllers */ 
define PNPdisketteO “PNPO700” /* PC Standard Floppy Disk Controller */ 


/* Display controllers */ 





define PNPdisplayO "PNP0900” /* VGA Compatible */ 
define PNPdisplayl "PNP0901” /* Video Seven VGA */ 
define PNPdisplay2 “PNP0902” /* 8514/A Compatible */ 
define PNPdisplay3 “PNP0903” /* Trident VGA */ 
define PNPdisplay4 “PNP0904” /* Cirrus Logic Laptop VGA */ 
define PNPdisplay5 “PNP0905” /* Cirrus Logic VGA */ 
define PNPdisplay6 “PNP0906” /* Tseng ET4000 or ET4000/W32 */ 
define PNPdisplay7 "PNP0907" /* Western Digital VGA */ 
define PNPdisplay8 “PNP0908” /* Western Digital Laptop VGA */ 
define PNPdisplay9 “PNP0909” /* 83 */ 
define PNPdisplayA “PNPO90A” /* ATI Ultra Pro/Plus (Mach 32) */ 
define PNPdisplayB “PNPO90B” /* ATI Ultra (Mach 8) */ 
define PNPdisplayC “PNPO90C” /* XGA Compatible */ 
define PNPdisplayD “PNPO90D” /* ATI VGA Wonder */ 
define PNPdisplayE “PNPO90E” /* Weitek P9000 Graphics Adapter */ 
define PNPdisplayF "PNP090F"” /* Oak Technology VGA */ 


/* Peripheral busses */ 




















define PNPbuses0 “PNP0A00” /* ISA Bus */ 
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define PNPbusesl 
define PNPbuses2 
define PNPbuses3 
define PNPbuses4 


/* RTC, BIOS, planar 


define PNPspeakerO 
define PNPrtcO 

define PNPpnpbios0 
define PNPpnpbiosl 
define PNPpnpbios2 
define PNPpnpbios3 


/* PCMCIA controller 
define PNPpcmciad 
/* Mice */ 


define PNPmoused 
define PNPmousel 
define PNPmouse2 
define PNPmouse3 
define PNPmouse4 
define PNPmouse5 
define PNPmouse6 
define PNPmouse7 
define PNPmouse8 
define PNPmouse9 
define PNPmouseA 
define PNPmouseB 


/* Modems */ 


define PNPmodemO 


define PNPnetworkC9 
define PNPnetworkCA 
define PNPnetworkCB 
define PNPnetworkCC 
define PNPnetwork27 
define PNPnetworket 
define PNPneteisaet 
define PNPAMD79C970 














define PNPscsiO0 
define PNPscsil 
define PNPscsi2 
define PNPscsi3 
define PNPscsiF 
define PNPscsi825 


define PNPmm0 
define PNPmml 
define PNPmmF 
define PNPv7310 
define PNPmm4232 














/* Network controllers */ 


/* SCSI controllers */ 


“PNPOAO1” 
“PNPOAQ2” 
“PNPOA03” 
“PNPOAO4” 


devices */ 


"PNP0800" 
"PNP0BO0" 
“PNPOCO0” 
"PNPOCO1" 
"PNP0CO2" 
“PNPOCO3” 


*/ 


“PNPOE00” 


“PNPOFO0” 
"PNPOFO1"” 
“PNPOFO2” 
“PNPOF03” 
“PNPOF04” 
“PNPOF05” 
“PNPOF06” 
“PNPOF07” 
“PNPOF08” 
“PNPOF09” 
“PNPOFOA” 
“PNPOFOB” 





“PNP9000” 


"PNP80C9" 
"PNP80CA" 
"PNP80CB" 
"PNP80CC" 
"PNP8327" 
“IBM0010” 
“IBM2001” 
“IBM0016” 








“PNPAOO 0” 
“PNPAOO1” 
“PNPA00 2” 
“PNPAO0O3” 
“IBMOOOF” 
“IBM001B” 


/* Sound/Video, Multimedia */ 


“PNPBOO 0” 
“PNPBOO1” 
“IBMOOOE” 
“IBM0015” 
“IBM0017” 





/* 
/* 
/* 
/* 


/* 
/* 
/* 
/* 
/* 
/* 


/* 


/* 
/* 
/* 
/* 
/* 
/* 
/* 
/* 
/* 
/* 
/* 
/* 


/* 


/* 
/* 
/* 
/* 
/* 
/* 
/* 
/* 


/* 
/* 
/* 
/* 
/* 
/* 


/* 
/* 
/* 
/* 
/* 


EISA Bus 
MCA Bus 

PCI Bus 
VESA/VL Bus 


AT Style Speaker Sound 

AT RTC 

PNP BIOS (only created by root enum) 
System Board Memory Device 

Math Coprocessor 

PNP BIOS Event Notification Interrupt 


Intel 82365 Compatible PCMCIA Cntlr 


Microsoft Bus Mouse 

Microsoft Serial Mouse 

Microsoft Inport Mouse 

Microsoft PS/2 Mouse 
Mousesystems Mouse 

Mousesystems 3 Button Mouse - COM2 
Genius Mouse - COM1 

Genius Mouse - COM2 

Logitech Serial Mouse 

Microsoft Ballpoint Serial Mouse 
Microsoft PNP Mouse 

Microsoft PNP Ballpoint Mouse 


Specific IDs TBD 


IBM Token Ring 

IBM Token Ring II 

IBM Token Ring II/Short 

IBM Token Ring 4/16Mbs 

IBM Token Ring (All types) 
IBM Ethernet used by Power PC 
IBM Ethernet EISA adapter 
AMD 79C970 (PCI Ethernet) 


Adaptec 154x Compatible SCSI Cntlr 
Adaptec 174x Compatible SCSI Cntlr 
Future Domain 16-700 Compat SCSI Cntlr 
Panasonic CDROM Adapter (SBPro/SB16) 
NCR 810 SCSI Controller 

NCR 825 SCSI Controller 


Sound Blaster Compatible Sound Device 
MS Windows Sound System Compat Device 
Crystal CS4231 Audio Device 

ASCII V7310 Video Capture Device 
Crystal CS4232 Audio Device 


3y 
*/ 
*/ 
27 


KN 
*/ 
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kl 
> 
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*/ 


Kj 
*/ 
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*/ 
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define PNPpmsyn "IBMO01D” 
define PNPgp4232 “IBM0012” 
define PNPmidi4232 “IBM0013” 


/* Operator Panel */ 
define PNPopctl "IBMO00B” 


/* Service Processor */ 
define PNPsp "IBMOO11” 


/* Memory Controller */ 
define PNPmemctl "IBMO00A” 


/* Graphics Assist */ 
define PNPg assist “IBM0014” 

















/* PNP Packet Handles */ 


define S1 Packet 
define S2_ Packet 
define S2 Packet flags 
define 83 Packet 
define S4 Packet 


define S4 Packet flags 
define S5 Packet 
define S6 Packet 
define S6 Packet priority 
define S7_ Packet 

define S8 Packet 

define S9 Packet_fixed 
define S14 Packet 

define S15 Packet 

define S15 Packet checksum 


Packet 


| 





define LI 
define L1_ Shadow 
define L1 32bit mem 
define L1 8 16bit mem 
define L1 Decode Hi 


define L1 Cache 





define L1 Writeable 
define L2 Packet 
define L3 Packet 
define L4 Packet 
define L5 Packet 





define L6 Packet 

define END_TAG 

define DF START TAG 

define DF START TAG priority 
define DF END TAG 

define SUBOPTIMAL CONFIGURATION 











/* Device Base Type Codes */ 


typedef enum PnP BASE TYPE ( 
Reserved = 0, 
MassStorageDevice = 1, 
NetworkInterfaceController = 2, 
DisplayController = 3, 
MultimediaController = 4, 
MemoryController = 5, 
BridgeController = 6, 


CommunicationsDevice = 7, 
SystemPeripheral = 8, 
InputDevice = 9, 


0x0A 
0x15 
0x16 
Ox1C 
0x22 
0x23 
0x2A 
0x30 
0x31 
0x38 
0x47 
0x4B 
0x71 
0x78 
0x79 
0x81 
0x20 
0x18 
0x10 
0x04 
0x02 
0x01 
0x82 
0x83 
0x84 
0x85 
0x86 
0x78 
0x30 
0x31 
0x38 
0x2 


/* 
/* 
/* 


/* 


/* 


/* 


/* 


YMF 289B chip (Yamaha) 
Crystal CS4232 Game Port 
Crystal CS4232 MIDI 


Operator’s panel 


IBM Service Processor 


Memory controller 


Graphics Assist 


/* Version resource 

/* Logical DEVID (without flags) 

/* Logical DEVID (with flags) 

/* Compatible device ID 

/* IRQ resource (without flags) 

/* IRQ resource (with flags) 

/* DMA resource 

/* Depend funct start (w/o priority) 
/* Depend funct start (w/ priority) 
/* Depend funct end 

/* I/O port resource (w/o fixed loc) 
/* I/O port resource (w/ fixed loc) 
/* Vendor defined 

/* End of resource (w/o checksum) 
/* End of resource (w/ checksum) 

/* Memory range 

/* Memory is shadowable 

/* 32-bit memory only 

/* 8- and 16-bit supported 

/* decode supports high address 

/* read cacheable, write-through 

/* Memory is writeable 

/* ANSI ID string 

/* Unicode ID string 

/* Vendor defined 

/* Large I/O 

/* 32-bit Fixed Loc Mem Range Desc 
/* End of resource 

/* Dependent function start 

/* Dependent function start 

/* Dependent function end 

/* Priority byte sub optimal config 
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} PnP BASE TYPE; 
/* Device Sub Type Codes */ 


typedef enum PnP SUB TYPE { 
SCSIController = 0, 
IDEController = 1, 
FloppyController = 2, 
IPIController = 3, 
OtherMassStorageController = 0x80, 


EthernetController = 0, 
TokenRingController = 1, 
FDDIController = 2, 
OtherNetworkController = 0x80, 


VGAController= 0, 
SVGAController= 1, 
XGAController= 2, 
OtherDisplayController = 0x80, 


VideoController = 0, 
AudioController = 1, 
OtherMultimediaController = 0x80, 





8 


M= 0, 
LASH = 1, 
OtherMemoryDevice = 0x80, 


zj 





Host ProcessorBridge = 0, 
SABridge = 1, 

EISABridge = 2, 
MicroChannelBridge = 3, 
PCIBridge = 4, 
PCMCIABridge = 5, 
VMEBridge = 6, 
OtherBridgeDevice = 0x80, 








RS232Device = 0, 
ATCompatibleParallelPort = 1, 
OtherCommunicationsDevice = 0x80, 


ProgrammableInterruptController = 0, 
DMAController = 1, 

SystemTimer = 
RealTimeClock 
L2Cache = 4, 
NVRAM = 5, 
PowerManagement = 6, 
CMOS = 7, 
OperatorPanel = 8, 
ServiceProcessorClassl 


Ilo N 
w 





Il 
Ko] 


ServiceProcessorClass2 


OxA, 
ServiceProcessorClass3 OxB, 
GraphicAssist = 0xC, 
SystemPlanar = OxF, 


OtherSystemPeripheral = 0x80, 


KeyboardController = 0, 
Digitizer = 1, 
MouseController = 2, 
OtherInputController = 0x80, 


GeneralMemoryController = 0, 
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} PnP SUB TYPE; 
/* Device Interface Type Codes */ 


typedef enum PnP INTERFACE ( 
General = 0, 
GeneralSCSI = 0, 
GeneralIDE = 0, 
ATACompat ible 


i] 
H 


GeneralFloppy 
Compatible765 = 
NS398_Floppy 


UH 
N 


i] 
e Ww 


NS26E_Floppy 
NS15C_Floppy 
NS2E_Floppy 
CHRP_Floppy 


ou 
A 


GeneralIPI = 0, 


GeneralEther = 





GeneralToken = 
General FDDI 





1i 
lo} 


GeneralVGA = 0, 
GeneralSVGA = 0, 
GeneralXGA = 0, 


GeneralVideo = 
GeneralAudio = 
CS4232Audio = 1, 


GeneralRAM = 0, 
GeneralFLASH = 0, 
PCIMemoryController = 0, 
RS6KMemoryController = 1, 


GeneralHostBridge = 0, 
GeneralISABridge = 0, 
GeneralEISABridge = 0, 
GeneralMCABridge = 
GeneralPCIBridge = 
PCIBridgeDirect = 0, 
PCIBridgeIndirect = 1, 
PCIBridgeRS6K = 2, 
General PCMCIABridge = 0, 
GeneralVMEBridge = 0, 











GeneralRS232 = 0, 
COMx = 1, 

Compatible16450 
Compatible16550 
NS398SerPort = 4, 


oul 
w N 


NS26ESerPort = 
NS15CSerPort = 
NS2ESerPort = 7, 


GeneralParPort = 0, 
LPTx = 1, 
NS398ParPort = 2, 


/* NS Super I/O wired to use index 
register at port 398 and data 
register at port 399 

/* Ports 26E and 26F 

/* Ports 15C and 15D 

/* Ports 2E and 2F 

/* CHRP Floppy in PR*P Systems 


/* CS 4232 Plug ‘n Play Configured 


/* PCI Config Method 
/* RS6K Config Method 


/* NS Super I/O wired to use index 
register at port 398 and data 
register at port 399 

/* Ports 26E and 26F 

/* Ports 15C and 15D 

/* Ports 2E and 2F 


/* NS Super I/O wired to use index 
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NS26EParPort = 3 
NS15CParPort = 4, 
NS2EParPort = 5, 


GeneralPIC = 0, 
ISA PIC = 1 


EISA PIC 
MPIC = 3, 
RS6K PIC = 4, 


GeneralDMA = 0, 
ISA DMA = 1, 
EISA DMA = 2, 





GeneralTimer = 0, 
ISA Timer = 1, 
EISA Timer = 2, 
GeneralRTC = 0 
ISA RIC = 1, 





StoreThruOnly = 1, 
StoreInEnabled = 2, 
RS6KL2Cache = 3, 
IndirectNVRAM = 0, 
DirectNVRAM = 1, 
IndirectNVRAM24 = 2, 


GeneralPowerManagement = 0, 
EPOWPowerManagement = 1, 
PowerControl = 2, 


GeneralCMOS = 0, 


GeneralOPPanel = 0, 
HarddiskLight = 1, 
CDROMLight = 2, 
PowerLight = 3, 

KeyLock = 4, 

ANDisplay = 5, 
SystemStatusLED = 6, 
CHRPSystemStatusLED = 7, 


GeneralServiceProcessor = 0, 
TransferData = 1, 

IGMC32 = 2, 

IGMC64 = 3, 


GeneralSystemPlanar = 0, 
) PnP INTERFACE; 
/* PnP resources */ 
/* Compressed ASCII is 5 bits per char; 


typedef struct SERIAL ID { 
unsigned char VendorID0; 


register at port 398 and data 
register at port 399 

/* Ports 26E and 26F 

/* Ports 15C and 15D 

/* Ports 2E and 2F 


/* Indirectly addressed 
/* Memory Mapped 
/* Indirectly addressed - 24 bit 


// d1378 


/* AlphaNumeric Display 
/* 3 digit 7 segment LED 
/* CHRP LEDs in PR*P System 


00001=A 11010=Z */ 

/* Bit (7)=0 

/* Bits(6:2)=1st character in 
/* compressed ASCII 

/* Bits(1:0)=2nd character in 


*/ 
*/ 
kr 
*/ 


sy 
*/ 
*/ 


af 
KA 
*/ 


*/ 
*/ 
*/ 
KV 
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/* compressed ASCII bits (4:3) */ 

unsigned char VendorID1; /* Bits(7:5)=2nd character in */ 
/* compressed ASCII bits (2:0) */ 

/* Bits(4:0)=3rd character in */ 

/* compressed ASCII */ 

unsigned char VendorID2; /* Product number - vendor assigned */ 
unsigned char VendorID3; /* Product number - vendor assigned */ 
/* Serial number is to provide uniqueness if more than one board of same */ 
/* type is in system. Must be “FFFFFFFF” if feature not supported. */ 
unsigned char SerialO; /* Unique serial number bits (7:0) */ 
unsigned char Seriall; /* Unique serial number bits (15:8) */ 
unsigned char Serial2; /* Unique serial number bits (23:16) */ 
unsigned char Serial3; /* Unique serial number bits (31:24) */ 


unsigned char Checksum; 
} SERIAL ID; 


typedef enum PnPItemName ( 
Unused = 0, 

PnPVersion = 1, 

LogicalDevice = 2, 

CompatibleDevice = 3, 

RQFormat = 4, 

DMAFormat 

StartDepFunc = 6, 

EndDepFunc = 7, 

OPort = 8, 

FixedIOPort = 9, 

Resi = 10, 

Res2 = 11, 

Res3 = 12, 

SmallVendorItem = 14, 

EndTag = 15, 

MemoryRange = 1, 

ANSIIdentifier = 2, 

UnicodeIdentifier = 3, 


i] 
UT 








LargeVendorItem = 4, 
MemoryRange32 = 5, 
MemoryRangeFixed32 = 6, 
) PnPItemName; 


/* Define a bunch of access functions for the bits in the tag field */ 


/* Tag type - 0 = small; 1 = large */ 








define tag type(t) (((t) & 0x80)>>7) 

define set tag type(t,v) (t = (t & 0x7f) | ((v)<<7) 

/* Small item name is 4 bits - one of PnPItemName enum above */ 
define tag small item name(t) (((t) & 0x78)>>3) 

define set tag small item name(t,v) (t = (t & 0x07) | ((v) <<3) 
/* Small item count is 3 bits - count of further bytes in packet */ 
define tag small count (t) ((t) & 0x07) 

define set tag count (t,v) (t = (t & 0x78) | (v)) 

/* Large item name is 7 bits - one of PnPItemName enum above */ 
define tag large item name(t) ((t) & 0x7f) 

define set tag large item name(t,v) (t = (t | 0x80) | (v)) 


/* a PnP resource is a bunch of contiguous TAG packets ending with an end tag */ 


typedef union PnP TAG PACKET { 
struct 81 Pack( /* VERSION PACKET */ 
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unsigned char Tag; 
unsigned char Version [2] ; 
) S1_Pack; 


struct _S2_Pack{ 
unsigned char Tag; 
unsigned char DevId[4]; 
unsigned char Flags [2]; 


) 82 Pack; 


struct $8S3 Pack( 
unsigned char Tag; 
unsigned char CompatId[4]; 
) 83 Pack; 


struct 84 Pack( 
unsigned char Tag; 
unsigned char IRQMask [2]; 


unsigned char IRQInfo; 


) 84 Pack; 


struct $S5 Pack( 
unsigned char Tag; 
unsigned char DMAMask; 
unsigned char DMAInfo; 
) 85 Pack; 


struct 86 Pack( 


unsigned char Tag; 
unsigned char Priority; 


) 56 Pack; 


struct _S7_Pack{ 


unsigned char Tag; 
) S7_Pack; 

struct _S8 Pack{ 
unsigned char Tag; 


unsigned char IOInfo; 

#define ISAAddri6bit 0x01 
unsigned char RangeMin[2]; 
unsigned char RangeMax[2]; 
unsigned char IOAlign; 
unsigned char IONum; 

} S8_ Pack; 





struct _S9 Pack{ 
unsigned char Tag; 
unsigned char Range [2]; 
unsigned char IONum; 
) S9_Pack; 








struct $14 Pack{ 


/* 
/* 


/* 
/* 
/* 
/* 
/* 
/* 


/* 
/* 
/* 


/* 
/* 
/* 
/* 
/* 
/* 
/* 
/* 
/* 
/* 


/* 
/* 
/* 


/* 
/* 
/* 
/* 
/* 
/* 


/* 
/* 


/* 
/* 
/* 
/* 
/* 
/* 
/* 
/* 


/* 
/* 
/* 
/* 


/* 


small tag = 0x0a 
PnP version, Vendor version 


LOGICAL DEVICE ID PACKET 

small tag = 0x15 or 0x16 

Logical device id 

bit(0) boot device; 

bit(7:1) cmd in range x31-x37 
bit(7:0) cmd in range x28-x3f (opt) 


COMPATIBLE DEVICE ID PACKET 
small tag = Oxl1c 
Compatible device id 


IRQ PACKET 

small tag = 0x22 or 0x23 

bit(0) is IRQO, ...; 

bit(0) is IRQ8 

optional; assume bit(0)=1; else 
bit(0) - high true edge sensitive 


bit(1) - low true edge sensitive 
bit (2) - high true level sensitive 
bit(3) - low true level sensitive 
bit(7:4) - must be 0 

DMA PACKET 


small tag = 0x2a 
bit(0) is channel 0 


START DEPENDENT FUNCTION PACKET 
small tag = 0x30 or 0x31 

Optional; if missing then x01; else 
x00 = best possible 

x01 = acceptible 

x02 = sub-optimal but functional 


END DEPENDENT FUNCTION PACKET 
small tag = 0x38 


VARIABLE I/O PORT PACKET 

small tag x47 

x0 = decode only bits(9:0); 
x01 = decode bits(15:0) 

Min base address 

Max base address 

base alignmt, incr in 1B blocks 
number of contiguous I/O ports 


FIXED I/O PORT PACKET 

small tag = 0x4b 

base address 10 bits 

number of contiguous I/O ports 


VENDOR DEFINED PACKET 


*/ 
*/ 


*/ 
*/ 
kr 
A 
A 
*/ 


*/ 
*/ 
*/ 


*/ 
ay 
*/ 
*/ 
*/ 
kl 
x% 
ay 
hå 
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unsigned char Tag; /* small tag = 0x7m m = 1-7 */ 
union 814 Data( 
unsigned char Data[7]; /* Vendor defined */ 
struct 814 PPCPack{ /* Pr*p s14 pack */ 
unsigned char Type; /* 00=non-IBM */ 
unsigned char PPCData [6]; /* Vendor defined */ 
} 814 PPCPack; 
} 814 Data; 
) 814 Pack; 
struct 815 Pack( /* END PACKET */ 
unsigned char Tag; /* small tag = 0x78 or 0x79 */ 
unsigned char Check; /* optional - checksum */ 
) 815 Pack; 
struct L1 Pack( /* MEMORY RANGE PACKET */ 
unsigned char Tag; /* large tag = 0x81 */ 
unsigned char Count0; /* x09 */ 
unsigned char Countl; /* x00 */ 
unsigned char Data[9]; /* a variable array of bytes, */ 
/* count in tag */ 
) LL Pack; 
struct L2 Pack( /* ANSI ID STRING PACKET */ 
unsigned char Tag; /* large tag = 0x82 */ 
unsigned char Count0; /* Length of string */ 
unsigned char Countl; 
unsigned char Identifier [1]; /* a variable array of bytes, */ 
/* count in tag */ 
) L2 Pack; 
struct L3 Pack( /* UNICODE ID STRING PACKET */ 
unsigned char Tag; /* large tag = 0x83 */ 
unsigned char Count0; /* Length + 2 of string */ 
unsigned char Count1; 
unsigned char Country0; /* TBD */ 
unsigned char Countryl; /* TBD */ 
unsigned char Identifier [1]; /* a variable array of bytes, */ 
/* count in tag */ 
} L3 Pack; 
struct L4 Pack( /* VENDOR DEFINED PACKET */ 
unsigned char Tag; /* large tag = 0x84 */ 


unsigned char Count0; 
unsigned char Countl; 
union L4 Data( 





unsigned char Data[1]; /* a variable array of bytes, */ 
/* count in tag */ 
struct _L4 PPCPack( /* Pr*p L4 packet */ 
unsigned char Type; /* 00=non-IBM */ 
unsigned char PPCData [1]; /* a variable array of bytes, */ 
/* count in tag */ 
} L4 PPCPack; 
) L4 Data; 
) L4 Pack; 


struct L5 Pack( 
unsigned char Tag; /* large tag = 0x85 */ 
unsigned char Count0; /* Count = 17 */ 
unsigned char Countl; 
unsigned char Data[17]; 
} L5 Pack; 


struct L6 Pack{ 
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unsigned char Tag; /* large tag = 0x86 */ 
unsigned char Count0; /* Count = 9 */ 
unsigned char Countl; 

unsigned char Data[9]; 

} L6 Pack; 


) PnP TAG PACKET; 


Hendif /* ndef PNP */ 
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